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Introduction 


1.1 Overview 

This guide introduces several basic XENIX facilities, including mail, text 
editors, and powerful operating environments called “shells.” 


1.2 About This Guide 

This guide is organized as follows: 

Chapter 1, “Introduction,” gives an introduction and overview of the 
XENIX system. It also gives a list of conventions used throughout this 
guide. 

Chapter 2, “vi,” explains how to use the screen editor, vi(C). 

Chapter 3, “mail,” describes the XENIX mail (C) facility and explains how 
to send and receive mail. 

Chapter 4, “The Shell,” describes use of the shell, ( sh (C) ), command 
interpreter and how to write procedures that can be executed by sh. 

Chapter 5, be. A Calculator,” explains how to use bc(C) a sophisticated 
calculator program . 

Chapter 6, “Building a Communications System, ” explains how to set up a 
system to permit communication between XENIX and/or UNIX systems 
using dial-up communication lines. 

Chapter 7, The C-Shell,” describes howto use csh(C). Itcovers the syn- 
tax and function of C-shell, ( esh (C) ), commands and features, and how 
to create shell procedures. 

Chapter 8, “Using The Visual Shell,” describes the use and behavior of the 
Visual Shell, ( vsh (C) ), which is a menu-driven XENIX shell. This 
chapter assumes the reader is familiar with some general XENIX concepts, 
but vsh can be used by first-time users. 

Appendix A “ed” explains how to use the editor, ed(C). 


1.3 Where To Find More Information 

This guide does not attempt to give information about installing, manag- 
ing, and maintaining the system, nor does it discuss document prepara- 
tion, software development, or many of the specialized utilities available in 
other XENIX system products. 
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You can find more information on these subjects in the guides found in the 
following binders: 

“Run Time Environment” 

The XENIX Installation Guide describes how to install and set up 
the XENIX system on your computer. 

Introduction to XENIX introduces the XENIX system by present- 
ing key concepts in a tutorial format. 

The XENIX Operations Guide explains how to manage and main- 
tain the system. 

Hardware Dependent Reference serves as a comprehensive com- 
mand reference, for Hardware Dependent (HW) commands. 


“User’s Reference” 

The XENIX User's Reference serves as a comprehensive, 
hardware independent. Operating System, command reference. 
A concise but complete description of each command is avail- 
able here. It includes manual pages for Commands(C), 
Miscellaneous(M) , and File Formats(F). 


“Programmer’s Reference” 

The XENIX Programmer's Reference serves as a comprehensive 
Development System command reference. It includes the 
manual page reference sections for Programming 
Commands(CP), System Calls(S), and DOS Routines(DOS). 
This guide is part of the optional XENIX Development System. 


“Programmer’s Guide I” 

The XENIX Programmer's Guide discusses how to use the pro- 
gramming tools available in the XENIX programming environ- 
ment. This guide is part of the optional XENIX Development Sys- 
tem. 

"C Language Reference ' describes the various elements of the C 
programming language. It is intended as a reference for program- 
mers already familiar with C or another language. This guide is 
part of the optional XENIX Development System. 
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“Programmer’s Guide II” 

C User’s Guide discusses writing C language programs that inter- 
face to the XENIX operating system. It provides reference to sys- 
tem calls, subroutines, and file formats. This guide is part of the 
optional XENIX Development System. 

C Library Guide provides information about the standard include 
files, tells how to build user interfaces for C programs, provides a 
full description of error messages, and provides information on 
cross development including a list of library routines common to 
both XENIX and DOS. This guide is part of the optional XENIX 
Development System. 

Macro Assembler (MASM) User’s Guide explains how to create 
and debug assembly language programs using the Macro Assem- 
bler, MASM, ( masm (CP) ). This guide is part of the optional 
XENIX Development System. 

Macro Assembler (MASM) Reference Manual describes the usage 
and input syntax of the Macro Assembler, MASM, ( masm (CP) 
). This guide is part of the optional XENIX Development System. 


“Text Processing Guide” 

The XENIX Text Processing Guide explains how to use the text 
processing and text formatting tools and includes the manual 
pages for Text Commands(CT). It is a part of the optional 
XENIXText Processing System. 


1.4 Notational Conventions 

This guide uses a number of notational conventions to describe the syntax 
of XENIX commands: 

Initial Capitals Initial Capitals indicate the name of a command 

or mode. When a command is introduced it is 
followed by the keystroke that invokes it, (i.e. 
the Insert (i) command). 

boldface Boldface indicates a command, option, flag, or 

program name to be entered as shown. 
Keystrokes are boldfaced when they indicate a 
command to enter as shown, (i.e. enter the i 
command and press RETURN ). 
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italics 


[ 1 


Boldface indicates the name of a library routine. 
(To find more information on a given library 
routine consult the “Alphabetized List” in your 
XENIX Reference Manual for the manual page 
that describes it.) 

Italics indicate a filename. This pertains to 
library include filenames (i.e. stdio.h), as well 
as, other filenames (i.e. I etc! ttys). 

Italics indicate a placeholder for a command 
argument. When entering a command , a place- 
holder must be replaced with an appropriate 
filename, number, or option. 

Italics indicate a specific identifier, supplied for 
variables and functions, when mentioned in 
text. 

Italics indicate a reference to part of an exam- 
ple. 

Italics indicate emphasized words or phrases in 
text. 

Brackets indicate that the enclosed item is 
optional. If you do not use the optional item, 
the program selects a default action to carry out. 

Brackets indicate the position of the cursor in 
text examples. 

Ellipses indicate that you can repeat the preced- 
ing item any number of times. 

Vertical ellipses indicate that a portion of a pro- 
gram example is omitted. 

Quotation marks indicate the first use of a 
technical term. 

Quotation marks indicate a reference to a word 
rather than a command. 


1-4 



Chapter 2 
vi: A Text Editor 


2.1 Introduction 2-1 

2.2 Demonstration 2-1 

2.2.1 Entering the Editor 2-2 

2.2.2 InsertingText 2-3 

2.2.3 Repeating a Command 2-4 

2.2.4 Undoing a Command 2-4 

2.2.5 Moving the Cursor 2-5 

2.2.6 Deleting 2-6 

2.2.7 Searching for a Pattern 2-10 

2.2.8 Searching and Replacing 2-11 

2.2.9 Leavingvi 2-14 

2.2.10 AddingText From Another File 2-14 

2.2.11 Leavingvi Temporarily 2-15 

2.2.12 Changing Your Display 2-15 

2.2.13 Canceling an Editing Session 2-16 

2.3 EditingTasks 2-17 

2.3.1 Howto Enter the Editor 2-17 

2.3.2 Moving the Cursor 2-18 

2.3.3 Moving Around in a File: Scrolling 2-21 

2.3.4 InsertingText Before the Cursor: i and.1 2-22 

2.3.5 Appending After the Cursor: a and A 2-22 

2.3.6 Correcting Typing Mistakes 2-23 

2.3.7 Opening a New Line 2-23 

2.3.8 Repeating the Last Insertion 2-23 

2.3.9 InsertingText From Other Files 2-23 

2.3.10 Inserting Control Characters into Text 2-28 

2.3.11 Joining and Breaking Lines 2-28 

2.3.12 Deleting a Character: x and X 2-28 

2.3.13 Deleting a Word: dw 2-29 

2.3.14 Deleting a Line: D and dd 2-29 

2.3.15 Deleting an Entire Insertion 2-30 

2.3.16 Deleting and Replacing Text 2-30 

2.3.17 MovingText 2-34 

2.3.18 Searching: / and ? 2-38 

2.3.19 Searching and Replacing 2-40 

2.3.20 Pattern Matching 2-43 

2.3.21 Undoing a Command :u 2-45 

2.3.22 Repeating a Command: . 2-47 



2.3.23 Leaving the Editor 2-48 

2.3.24 Editing a Series of Files 2-49 

2.3.25 Editing a New File Without Leaving the Editor 2-51 

2.3.26 Leaving the Editor Temporarily: Shell Escapes 2-52 

2.3.27 Performing a Series of Line-Oriented Commands: Q 2-53 

2.3.28 Finding Out What File You’re In 2-53 

2.3.29 Finding Out What Line You’re On 2-54 

2.4 Solving Common Problems 2-54 

2.5 SettingUp Your Environment 2-55 

2.5.1 Setting the Terminal Type 2-56 

2.5.2 Setting Options: The set Command 2-56 

2.5.3 Displaying Tabs and End-of-Line: list 2-57 

2.5.4 Ignoring Case in Search Commands: ignorecase 2-58 

2.5.5 Displaying Line Numbers: number 2-58 

2.5.6 Printing the Number of Lines Changed: report 2-58 

2.5.7 Changing the Terminal Type :term 2-58 

2.5.8 Shortening Error Messages: terse 2-59 

2.5.9 Turning Off Warnings: warn 2-59 

2.5. 10 Permitting Special Characters in Searches: nomagic 2-59 

2.5.11 Limiting Searches: wrapscan 2-59 

2.5.12 Turning on Messages: mesg 2-60 

2.5.13 Customizing Your Environment: The .exrc File 2-60 

2.6 Summary of Commands 2-61 



vi: A Text Editor 


2.1 Introduction 

Any ASCII text file, such as a program or document, may be created and 
modified using a text editor. Two text editors that are available on the 
XENIX system, ed and vi. ed is discussed in Appendix A of this manual. 

vi (which stands for “visual”) combines line-oriented and screen-oriented 
features into a powerful set of text editing operations that will satisfy any 
text editing need. 

The first part of this chapter is a demonstration that gives you some hands- 
on experience with vi. It introduces the basic concepts you must be familiar 
with before you can really learn to use vi, and shows you how to perform 
simple editing functions. The second part is a reference that shows you 
how to perform specific editing tasks. The third part describes how to set 
up your vi environment and how to set optional features. The fourth part is 
a summary of commands. 

Because vi is such a powerful editor, it has many more commands than you 
can learn at one sitting. If you have not used a text editor before, the best 
approach is to become thoroughly comfortable with the concepts and 
operations presented in the demonstration section, then refer to the 
second part for specific tasks you need to perform. All the steps needed to 
perform a given task are explained in each section, so some information is 
repeated several times. When you are familiar with the basic vi commands 
you can easily learn how to use the more advanced features. 

If you have used a text editor before, you may want to turn directly to the 
task-oriented part of this chapter. Begin by learning the features you will 
use most often. If you are an experienced user of vi you may prefer to use 
vi(C) in the XENIX Reference Manual instead of this chapter. 

This chapter covers the basic text editing features of vi. For more advanced 
topics, and features related to editing programs, refer to vi(C) in the 
XENIX Reference Manual. 


2.2 Demonstration 

The following demonstration gives you hands-on experience using vi, and 
introduces some basic concepts that you must understand before you can 
learn more advanced features. You will learn how to enter and exit the edi- 
tor, insert and delete text, search for patterns and replace them, and how 
to insert text from other files. This demonstration should take one hour. 
Remember that the best way to learn vi is to actually use it, so don’t be 
afraid to experiment. 

Before you start the demonstration, make sure that your terminal has been 
properly set up. See section 2.5.1, “Setting the Terminal Type” , for more 
information about setting up your terminal for use with vi. 
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2.2. 1 Entering the Editor 

To enter the editor and create a file named temp , enter: 
vi temp 

Your screen will look like this: 


"temp" [New file] 


Note that we show a twelve-line screen to save space. In reality, vi uses 
whatever size screen you have. 

You are initially editing a copy of the file. The file itself is not altered until 
you save it. Saving a file is explained later in the demonstration. The top 
line of your display is the only line in the file and is marked by the cursor, 
shown above as an underline character. In this chapter, when the cursor is 
on a character that character will be enclosed in square brackets ([]). 


The line containing the cursor is called the current line. 


The lines containing tildes are not part of the file: they indicate lines on the 
screen only, not real lines in the file. 
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2.2.2 Inserting Text 

To begin, create some text in the file temp by using the Insert (i) command. 
To do this, press: 

i 

Next, enter the following five lines to give yourself some text to experiment 
with. Press RETURN at the end of each line. If you make a mistake, use the 
BKSP key to erase the error and enter the word again. 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Press the ESCAPE key (abbreviated ESC) when you are finished. 

Like most vi commands, the i command is not shown (or “echoed”) on 
your screen. The command itself switches you from Command mode to 
Insert mode. 


When you are in Insert mode every character you enter is displayed 
on the screen. In Command mode the characters you enter are not 
placed in the file as text; they are interpreted as commands to be 
executed on the file. If you are not certain which mode you are in, 
press ESC until you hear the bell. When you hear the bell you 
are in Command mode. 


Once in Insert mode, the characters you enter are inserted into the file; 
they are not interpreted as vi commands. To exit Insert mode and reenter 
Command mode you will always press ESC . This switching between modes 
occurs often in vi, and it is important to get used to it now. 
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2.2.3 Repeating a Command 

Next comes a command that you will use frequently in vi: the Repeat com- 
mand. The Repeat command repeats the most recent Insert or Delete 
command. Since we have just executed an Insert command, the Repeat 
command repeats the insertion, duplicating the inserted text. The Repeat 
command is executed by entering a period (.) or “dot” . So, to add five 
more lines of text, enter The Repeat command is repeated relative to 
the location of the cursor and inserts text below the current line. 
(Remember, the current line is always the line containing the cursor.) 
After you enter dot (.), your screen will look like this: 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


2.2.4 Undoing a Command 

Another command which is very useful (and which you will need often in 
the beginning) is the Undo (u) command. Press 

u 

and notice that the five lines you just finished inserting are deleted or 
“undone”. 
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Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Now enter: 
u 

again, and the five lines are reinserted! This undo feature can be very use- 
ful in recovering from inadvertent deletions or insertions. 


2.2.5 Moving the Cursor 

Now let’s learn how to move the cursor around on the screen. In addition 
to the arrow keys, the following letter keys also control the cursor: 

h Left 

1 Right 

k Up 

j Down 

The letter keys are chosen because of their relative positions on the key- 
board. Remember that the cursor movement keys only work in Command 
mode. 

Try moving the cursor using these keys. (First make sure you are in Com- 
mand mode by pressing the ESC key.) Then, enter the H command to place 
the cursor in the upper left comer of the screen. Then enter the L com- 
mand to move to the lowest line on the screen . (Note that case is significant 
in our example: L moves to the lowest line on the screen; while 1 moves the 
cursor forward one character.) Next, try moving the cursor to the last line 
in the file with the goto command, G. If you enter 2G, the cursor moves to 
the beginning of the second line in the file; if you have a 10,000 line file, and 
enter 88S8G, the cursor goes to the beginning of line 8888. (If you have a 
600 line file and enter 800G the cursor does not move.) 
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These cursor movement commands should allow you to move around well 
enough for this demonstration. Other cursor movement commands you 
might want to try out are : 


w 

Moves forward a word 

b 

Backs up a word 

0 

Moves to the beginning of a line 

$ 

Moves to the end of a line 

You can move through many lines quickly with the scrolling commands: 

Ctrl-u 

Scrolls up 1/2 screen 

Ctrl-d 

Scrolls down 1/2 screen 

Ctrl-f 

Scrolls forward one screenful 

Ctrl-b 

Scrolls backward one screenful 

2.2.6 Deleting 

Now that we know how to insert and create text, and how to move around 
within the file, we are ready to delete text. Many Delete commands can be 
combined with cursor movement commands, as explained below. The 
most common Delete commands are: 

dd 

Deletes the current line (the line the cursor is on), regard- 
less of the location of the cursor in the line. 

dw 

Deletes the word above the cursor. If the cursor is in the 
middle of the word, deletes from the cursor to the end of 
the word. 

X 

Deletes the character above the cursor. 

d$ 

Deletes from the cursor to the end of the line. 

D 

Deletes from the cursor to the end of the line. 

dO 

Deletes from the cursor to the start of the line. 

• 

Repeats the last change. (Use this only if your last com- 
mand was a deletion.) 
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To learn how all these commands work, we will delete various parts of the 
demonstration file. To begin, press ESC to make sure you are in Command 
mode, then move to the first line of the file by entering: 

1G 

At first, your file should look like this: 


[F]iles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


To delete the first line, enter: 
dd 

Your file should now look like this: 


[T]ext contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Delete the word the cursor is sitting on by entering: 
dw 
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After deleting, your file should look like this: 


[cjontains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


You can quickly delete the character above the cursor by pressing: 
x 

This leaves: 


[o]ntains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Now enter a w command to move your cursor to the beginning of the word 
lines on the first line. Then, to delete to the end of the line, enter: 

d$ 
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Your file looks like this: 


ontains_ 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


To delete all the characters on the line before the cursor enter: 
dO 

This leaves a single space on the line: 


Lines contain characters. 
Files contain text. 

Text contains lines. 
Characters form words. 
Words form text. 

Lines contain characters. 
Characters form words. 
Words form text. 
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For review, let’s restore the first two lines of the file. 

Press i to enter Insert mode, then enter: 

Files contain text. 

Text contains lines. 

Press ESC to go back to Command mode. 


2.2.7 Searching fora Pattern 

You can search forward for a pattern of characters by entering a slash (/) 
followed by the pattern you are searching for, terminated by a RETURN. 
For example, make sure you are in Command mode (press ESC), then 
press 


H 

to move the cursor to the top of the screen. Now, enter: 

/char 

Do not press RETURN yet. Your screen should look like this: 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


/char_ 


Press RETURN. The cursor moves to the beginning of the word characters 
on line three. To search for the next occurrence of the pattern char , press 
n (as in “next”) . This will take you to the beginning of the word characters 
on the eighth line. If you keep pressing “n” vi searches past the end of the 
file, wraps around to the beginning, and again finds the char on line three. 
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Note that the slash character and the pattern that you are searching for 
appear at the bottom of the screen. This bottom line is the vi status line. 


The status line appears at the bottom of the screen. 

It is used to display information, including patterns you 
are searching for, line-oriented commands (explained 
later in this demonstration), and error messages. 


For example, to get status information about the file, press Ctrl-g. Your 
screen should look like this: 


Files contain text. 

Text contains lines. 

Lines contain characters. 

Characters form words. 

Words form text. 

Files contain text. 

Text contains lines. 

Lines contain [characters. 
Characters form words. 

Words form text. 

"temp" [Modified] line 4 of 10 --4% — 


The status line on the bottom tells you the name of the file you are editing, 
whether it has been modified, the current line number, the number of lines 
in the file, and your location in the file as a percentage of the number of 
lines in the file. The status line disappears as you continue working. 


2.2.8 Searching and Replacing 

Let’s say you want to change all occurrences of text in the demonstration 
file to documents. Rather than search for text ’, then delete it and insert 
documents , you can do it all in one command. The commands you have 
learned so far have all been screen- oriented. Commands that can perform 
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more than one action (searching and replacing) are line- oriented com- 
mands. 


Screen- oriented commands are executed at the location of the 
cursor. You do not need to tell the computer where to perform 
the operation; it takes place relative to the cursor. Line- oriented 
commands require you to specify an exact location (called an 
“address”) where the operation is to take place. 

Screen-oriented commands are easy to enter, and provide 
immediate feedback; the change is displayed on the screen. 
Line-oriented commands are more complicated to enter, but 
they can be executed independent of the cursor, and in more 
than one place in a file at a time. 


All line-oriented commands are preceded by a colon which acts as a 
prompt on the status line. Line-oriented commands themselves are 
entered on this line and terminated with a RETURN. 


In this chapter, all instructions for line-oriented 
commands will include the colon as part of the command. 


To change text to documents, press ESC to make sure you are in Command 
mode, then enter: 

: 1 , $s/ text/documents/g 

This command means “From the first line (1) to the end of the file ($), find 
text and replace it with documents (s/text/documents/) everywhere it 
occurs on each line (g)”. 
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Press RETURN. Your screen should look like this: 


Files contain documents. 
Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form documents. 
Files contain documents. 
Text contains lines. 

Lines contain characters. 
Characters form words. 
[W]ords form documents, 


Note that Text in lines two and eight was not changed. Case is significant in 
searches. 

Just for practice, use the Undo command to change documents back to 
text. Press: 

u 

Your screen now looks like this: 


[FJiles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 
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2.2.9 Leaving vi 

All of the editing you have been doing has affected a copy of the file, and 
not the file named temp that you specified when you invoked vi. To save the 
changes you have made, exit the editor and return to the XENIX shell, 
enter: 


Remember to press RETURN. The name of the file, and the number of 
lines and characters it contains are displayed on the status line: 

"temp" [New file] 10 lines, 214 characters 

Then the XENIX prompt appears. 


2.2.10 Adding Text From Another File 

In this section we will create a new file, and insert text into it from another 
file. First, create a new file named practice by entering: 

vi practice 


This file is empty. Let’s copy the text from temp and put it in practice with 
the line-oriented Read command. Press ESC to make sure you are in Com- 
mand mode, then enter: 

:r temp 

Your file should look like this: 


[F]iles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 
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The text from temp has been copied and put in the current file practice. 
There is an empty line at the top of the file. Move the cursor to the empty 
line and delete it with the dd command. 


2.2.11 Leaving vi Temporarily 

vi allows you to execute commands outside of the file you are editing, such 
as date. To find out the date and time, enter: 

:!date 


Press RETURN. This displays the date, then prompts you to press RETURN 
to reenter Command mode. Go ahead and try it. Your screen should look 
similar to this: 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

:!date 

Mon Jan 9 16:33:37 PST 1985 
[Hit return to continue]_ 


2.2.12 Changing Your Display 

Besides the set of editing commands described above, there are a number 
of options that can be set either when you invoke vi, or later when editing. 
These options allow you to control editing parameters such as line number 
display, and whether or not case is significant in searches. In this section 
we will learn how to turn on line numbering, and how to look at the current 
option settings. 
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To turn on automatic line numbering, enter: 
:set number 


Press RETURN. Your screen is redrawn, and line numbers appear to the 
left of the text. Your screen looks like this: 


1 Files contain text. 

2 Text contains lines. 

3 Lines contain characters. 

4 Characters form words. 

5 Words form text. 

6 Files contain text. 

7 Text contains lines. 

8 Lines contain characters. 

9 Characters form words. 
10 Words form text. 


You can get a complete list of the available options by entering: 
:set all 


and pressing RETURN. Setting these options is described in section 2.5 
“Setting Up Your Environment”, but it is important that you be aware of 
their existence. Depending on what you are working on, and your own 
preferences, you will want to alter the default settings for many of these 
options. 


2.2.13 Canceling an Editing Session 

Finally, to exit vi without saving the file practice, enter: 

:q! 


and press RETURN. This cancels all the changes you have made to practice 
and, since it is a new file, deletes it. The prompt appears. If practice had 
already existed before this editing session, the changes you made would be 
disregarded, but the file would still exist. 
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This completes the demonstration. You have learned how to get in and out 
of vi, insert and delete text, move the cursor around, make searches and 
replacements, how to execute line-oriented commands, copy text from 
other files, and cancel an editing session. 

There are many more commands to learn, but the fundamentals of using vi 
have been covered. The following sections will give you more detailed 
information about these commands and about vi’s other commands and 
features. 


2.3 Editing Tasks 

The following sections explain how to perform common editing tasks. By 
following the instructions in each section you will be able to complete each 
task described. Features that are needed in several tasks are described 
each time they are used, so some information is repeated. 


2.3.1 How to Enter the Editor 

There are several ways to begin editing, depending on what you are plan- 
ning to do. This section describes how to start, or “invoke” the editor with 
one filename. To invoke vi on a series of files, see section 2.3.24, “Editing a 
Series of Files”. 


With a Filename 

The most common way to enter vi is to enter the command vi and the name 
of the file you wish to edit: 

vi filename 

M filename does not already exist, anew, empty file is created. 


At a Particular Line 

You can also enter the editor at a particular place in a file. For example, if 
you wish to start editing a file at line 100, enter: 

vi +100 filename 

The cursor is placed at line 100 of filename . 
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At a Particular Word 

If you wish to begin editing at the first occurrence of a particular word, 
enter: 


vi +/word filename 


The cursor is placed at the first occurrence of word. For example, to begin 
editing the file temp at the the first occurrence of contain , enter: 

vi +/ contain temp 


2.3.2 Moving the Cursor 

The cursor movement keys allow you to move the cursor around in a file. 
Cursor movement can only be done in Command mode. 


Moving the Cursor By Characters: h j,k,l,SPACE,BKSP 

The SPACE bar and the 1 key move the cursor forward a specified number 
of characters. The BKSP key and the h key move it backward a specified 
number of characters. If no number is specified, the cursor moves one 
character. For example, to move backward four characters, enter: 

4h 

You can also move the cursor to a designated character on the current line. 
F moves the cursor back to the specified character, f moves it forward. The 
cursor rests on the specified character. For example, to move the cursor 
backward to the nearest p on the current line, enter: 

Fp 

To move the cursor forward to the nearest p, enter: 
f P 

The T and t keys work the same way as f and F, but place the cursor 
immediately before the specified character. For example, to move the cur- 
sor b ack to the space next to the nearest p in the current line, enter: 
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If the p were in the word telephone , the cursor would sit on the h. 

The cursor always remains on the same line when you use these com- 
mands. If you specify a number greater than the number of characters on 
the line, the cursor does not move beyond the beginning or end of that line. 


Moving the Curs or by W ords : w, W, b, B , e, E 

The w key moves the cursor forward to the beginning of the specified 
number of words. Punctuation and nonalphabetic characters (such as 
!@#$% &*()_+{}[]~|V<>/) are considered words, so if a word is fol- 
lowed by a comma the cursor will count the comma in the specified 
number. 

For example, your cursor rests on the first letter of this sentence: 

No, I didn’t know he had returned. 

If and you press: 

6w 

the cursor stops on the k in know. 

W works the same way as w, but includes punctuation and nonalphabetic 
characters as part of the word. Using the above example, if you press 

6W 

the cursor stops on the r in returned ; the comma and the apostrophe are 
included in their adjacent words. 

The e and E keys move the cursor forward to the end of a specified number 
of words. The cursor is placed on the last letter of the word. The e com- 
mand counts punctuation and nonalphabetic characters as separate 
words; E does not. 

B and b move the cursor back to the beginning of a specified number of 
words. The cursor is placed on the first letter of the word. The b command 
counts punctuation and nonalphabetic characters as separate words; B 
does not. Using the above example, if the cursor is on the r in returned , 
enter: 


4b 


and the cursor moves to the t in didn *t. 
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Enter: 


4B 

and the cursor moves to the first d in didn 7. 

The w, W, b and B commands will move the cursor to the next line if that is 
where the designated word is, unless the current line ends in a space. 


Moving the Cursor by Lines 

Forward: j, Ctrl- n, + , RETURN, LINEFEED, $ 

The RETURN, LINEFEED and + keys move the cursor forward a specified 
number of lines, placing the cursor on the first character. For example, to 
move the cursor forward six lines, enter: 

6 + 


The j and Ctrl- n keys move the cursor forward a specified number of lines. 
The cursor remains in the same place on the line, unless there is no charac- 
ter in that place, in which case it moves to the last character on the line. For 
example, in the following two lines if the cursor is resting on the e in charac- 
ters, pressing j moves it to the period at the end of the second line: 

Lines contain characters. 

Text contains lines. 


The dollar sign($) moves the cursor to the end of a specified number of 
lines. For example, to move the cursor to the last character of the line four 
lines down from the current line, enter: 

4$ 


Backward: k, Ctrl-p 

Ctrl- p and k move the cursor backward a specified number of lines, keep- 
ing it on the same place on the line. For example, to move the cursor back- 
ward four lines from the current line, enter: 

4k 
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Moving the Cursor on the Screen: H, M, L 

The H, M and L keys move the cursor to the beginning of the top, middle 
and bottom lines of the screen, respectively. 


2.3.3 Moving Around in a File: Scrolling 

The following commands move the file so different parts can be displayed 
on the screen. The cursor is placed on the first letter of the last line 
scrolled. 


Scrolling Up Part of the Screen: Ctrl- u 
Ctrl- u scrolls up one-half screen. 

Scrolling Up the Full Screen: Ctrl- b 
Ctrl-b scrolls up a full screen. 

Scrolling Down Part of the Screen: Ctrl- d 
Ctrl- d scrolls down one-half screen. 

Scrolling Down a Full Screen: Ctrl- f 
Ctrl- f scrolls down a full screen. 

Placing a Line at the Top of the Screen: z 

To scroll the current line to the top of the screen, press: 
z 

then press RETURN. To place a specific fine at the top of the screen, pre- 
cede the z with the line number, as in 

33z 

Press RETURN, and line 33 scrolls to the top of the screen. For information 
on how to display line numbers, see section 2.5.5, “Displaying Line 
Numbers: number”. 
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2.3.4 Inserting Text Before the Cursor: iandl 

You can begin inserting text before the cursor anywhere on a line, or at the 
beginning of a line. In order to insert text into a file, you must be in Insert 
mode. To enter Insert mode press: 

i 

The “i” does not appear on the screen. Any text typed after the “i” 
becomes part of the file you are editing. To leave Insert mode and reenter 
Command mode, press ESC . For more explanation of modes in vi, see sec- 
tion 2.2.2, “Inserting Text”. 


Anywhere on a Line: i 

To insert text before the cursor, use the i command. Press the /key to enter 
Insert mode (the “i” does not appear on your screen), then begin entering 
your text. To leave Insert mode and reenter Command mode, press ESC. 


At the Beginning of the Line: I 

Using an uppercase “I” to enter Insert mode also moves the cursor to the 
beginning of the current line. It is used to start an insertion at the beginning 
of the current line. 


2.3.5 Appending After the Cursor: a and A 

You can begin appending text after the cursor anywhere on a line, or at the 
end of a line. Press ESC to leave Insert mode and reenter Command mode. 


Anywhere on a Line: a 

To append text after the cursor, use the a command. Press the a key to 
enter Insert mode (the “a” does not appear on your screen), then begin 
entering your text. Press ESC to leave Insert mode and reenter Command 
mode. 


At the end of a Line: A 

Using an uppercase “A” to enter Insert mode also moves the cursor to the 
end of the current line. It is useful for appending text at the end of the 
current line. 
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2.3.6 Correcting Typing Mistakes 

If you make a mistake while you are typing, the simplest way to correct it is 
with the BKSP key. Backspace across the line until you have backspaced 
over the mistake, then retype the line. You can only do this, however, if the 
cursor is on the same line as the error. See sections 2.3.12 through 2.3.15 
for other ways to correct typing mistakes. 


2.3.7 Opening a New Line 

To open a new line above the cursor, press O. To open a new line below 
the cursor, press o. Both commands place you in Insert mode, and you 
may begin entering immediately. Press ESC to leave Insert mode and 
reenter Command mode. 

You may also use the RETURN key to open new lines above and below the 
cursor. To open a line above the cursor, move the cursor to the beginning 
of the line, press i to enter Insert mode, then press RETURN. (For informa- 
tion on how to move the cursor, see section 2.3.2, “Moving the Cursor”.) 
To open a line below the cursor, move the cursor to the end of the current 
line, press i to enter Insert mode, then press RETURN. 


2.3.8 Repeating the Last Insertion 

Ctrl-® repeats the last insertion. Press i to enter Insert mode, then press 

Ctrl-®. 

Ctrl- @ only repeats insertions of 128 characters or less. If more than 128 
characters were inserted, Ctrl- @ does nothing. 

For other methods of repeating an insertion, see section 2.3.8, “Repeating 
the Last Insertion”, section 2.3.9, “Inserting Text From Other Files”, and 
section 2.3.22, “Repeating a Command”. 


2.3.9 Inserting Text From Other Files 

To insert the contents of another file into the file you are currently editing, 
use the Read (r) command. Move the cursor to the line immediately above 
the place you want the new material to appear, then enter: 

:r filename 

where filename is the file containing the material to be inserted, and press 
RETURN. The text of filename appears on the line below the cursor, and 
the cursor moves to the first character of the new text. This text is a copy; 
the original filename still exists. 
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Inserting selected lines from another file is more complicated. The 
selected lines are copied from the original file into a temporary holding 
place called a “buffer”, then inserted into the new file. 

1. To select the lines to be copied, save your original file with the Write 
(:w) command , but do not exit vi. 

2. Enter: 

:e filename 

where filename is the file that contains the text you want to copy, and 
press RETURN. 

3. Move the cursor to the first line you wish to select. 

4. Enter: 

mk 

This “marks” the first line of text to be copied into the new file with 
the letter “k”. 

5. Move the cursor to the last line of the selected text. Enter: 

ii )i 

ay k 

The lines from your first “mark” to the cursor are placed, or 
“yanked” into buffer a. They will remain in buffer a until you 
replace them with other lines, or until you exit the editor. 

6. Enter: 


:e# 


to return to your previous file. (For more information about this 
command, see section 2.3.25, “Editing a New File Without Leaving 
the Editor”.) Move the cursor to the line above the place you want 
the new text to appear, then enter: 

ii 

ap 

This “puts” a copy of the yanked lines into the file, and the cursor is 
placed on the first letter of this new text. The buffer still contains the 
original yanked lines. 

You can have 26 buffers named a, b, c, up to and including z. To name and 
select different buffers, replace the a in the above examples with whatever 
letter you wish. 
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You may also delete text into a buffer, then insert it in another place. For 
information on this type of deletion and insertion, see section 2.3.17, 
“MovingText”. 


Copying Lines From Elsewhere in the File 

To copy lines from one place in a file to another place in the same file, use 
the Copy (co) command. 

co is a line-oriented command, and to use it you must know the line 
numbers of the text to be copied and its destination. To find out the 
number of the current line enter: 

:nu 

and press RETURN. The line number and the text of that line are displayed 
on the status line. To find out the destination line number, move the cursor 
to the line above where you want the copied text to appear and repeat the 
:nu command . You can also make line numbers appear throughout the file 
with the iinenumber option. For information on how to set this option, see 
section 2.5.5, “Displaying Line Numbers: number’ 5 . The following exam- 
ple uses the number option to display line numbers in a file. 


1 [FJiles contain text. 

2 Text contains lines. 

3 Lines contain characters. 

4 Characters form words. 

5 Words form text. 


Using the above example, to copy lines 3 and 4 and put them between lines 
1 and 2, enter: 

:3,4col 
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The result is: 


1 Files contain text. 

2 Lines contain characters. 

3 [Characters form words. 

4 Text contains lines. 

5 Lines contain characters. 

6 Characters form words. 

7 Words form text. 


If you have text that is to be inserted several times in different places, you 
can save it in a temporary storage area, called a “buffer”, and insert it 
whenever it is needed. For example, to repeat the first line of the following 
text after the last line: 


[F]iles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


1. Move the cursor over the F in Files. Enter the following line, which 
will not be echoed on your screen : 

"ayy 

This “yanks” the first line into buffer a. Move the cursor over the W 
in Words . 
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2. Enter the following line: 

" a P 

This “puts” a copy of the yanked line into the file, and the cursor is 
placed on the first letter of this new text. The buffer still contains the 
original yanked line. 

Your screen looks like this: 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 

[F]iles contain text. 


If you wish to “yank” several consecutive lines, indicate the number of 
lines you wish to yank after the name of the buffer. For example, to place 
three lines from the above text in buffer a, enter: 

"a3yy 


You can also use “yank” to copy parts of a line. For example, to copy the 
words FUes contain, enter: 

2yw 


This yanks the next two words, including the word on which you place the 
cursor. To yank the next ten characters, enter: 

lOyl 


/ indicates cursor motion to the right. To yank to the end of the line you are 
on, from where you are now, enter: 

y$ 
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2.3.10 Inserting Control Characters into Text 

Many control characters have special meaning in vi, even when typed in 
Insert mode. To remove their special significance, press Ctrl- v before typ- 
ing the control character. Note that Ctrl-j, Ctrl- q, and Ctrl-s cannot be 
inserted as text. Ctrl-j is a newline character. Ctrl- q and Ctrl- s are mean- 
ingful to the operating system, and are trapped by it before they are inter- 
preted by vi. 


2.3.11 Joining and Breaking Lines 

To join two lines press: 

J 

while the cursor is on the first of the two lines you wish to join. 

To break one line into two lines, position the cursor on the space preceding 
the first letter of what will be the second line, press: 

r 

then press RETURN. 


2.3. 12 Deleting a Character: x and X 

The x and X commands delete a specified number of characters. The x 
command deletes the character above the cursor; the X command deletes 
the character immediately before the cursor. If no number is given, one 
character is deleted. For example, to delete three characters following the 
cursor (including the character above the cursor), enter: 

3x 


To delete three characters preceding the cursor, enter: 
3X 
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2.3.13 Deleting a Word: dw 

The dw command deletes a specified number of words. If no number is 
given, one word is deleted. A word is interpreted as numbers and letters 
separated by whitespace. When a word is deleted, the space after it is also 
deleted. For example, to delete three words, enter: 

3dw 


2.3.14 Deleting a Line: D and dd 

The D command deletes all text following the cursor on that line, including 
the character the cursor is resting on. The dd command deletes a specified 
number of lines and closes up the space. If no number is given, only the 
current line is deleted. For example, to delete three lines, enter: 

3dd 


Another way to delete several lines is to use a line-oriented command. To 
use this command it helps to know the line numbers of the text you wish to 
delete. For information on how to display line numbers, see section 2.5.5, 
“Displaying Line Numbers: number”. 

For example, to delete lines 200 through 250, enter: 

:200,250d 

Press RETURN. 

When the command finishes, the message: 

50 lines 

appears on the vi status line, indicating how many lines were deleted . 

It is possible to remove lines without displaying line numbers using short- 
hand “addresses”. For example, to remove all lines from the current line 
(the line the cursor rests on) to the end of the file, enter: 

:.,$d 
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The dot (.) represents the current line, and the dollar sign stands for the 
last line in the file. To delete the current line and 3 lines following it, enter: 

:.,+3d 


To delete the current line and 3 lines preceding it, enter: 
:.,-3d 


For more information on using addresses in line-oriented commands, see 
vi(C) in the XENIX Reference Manual. 


2.3.15 Deleting an Entire Insertion 

If you wish to delete all of the text you just entered, press Ctrl- u while you 
are in Insert mode. The cursor returns to the beginning of the insertion. 
The text of the original insertion is still displayed, and any text you enter 
replaces it. When you press ESC, any text remaining from the original 
insertion disappears. 


2.3.16 Deleting and Replacing Text 

Several vi commands combine removing characters and entering Insert 
mode. The following sections explain how to use these commands. 


Overstriking: rand R 

The r command replaces the character under the cursor with the next char- 
acter entered. To replace the character under the cursor with a “b”, for 
example, enter: 

rb 


If a number is given before r, that number of characters is replaced with the 
next character entered. For example, to replace the character above the 
cursor, plus the next three characters, with the letter “b”, enter: 

4rb 

Note that you now have four “b”s in a row. 
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The R command replaces as many characters as you enter. To end the 
replacement, press ESC . For example, to replace the second line in the fol- 
lowing text with “Spelling is important. 


Files contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Move the cursor over the T in Text. Press R, then enter: 
Spelling is important. 


Press ESC to end the replacement. If you make a mistake, use the BKSP 
key to correct it. Your screen should now look like this: 


Files contain text. 
Spelling is important[.] 
Lines contain characters. 
Characters form words. 
Words form text. 
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Substituting: sandS 

The s command replaces a specified number of characters, beginning with 
the character under the cursor, with text you enter. For example, to substi- 
tute “xyz” for the cursor and two characters following it, enter: 

3sxyz 


The S command deletes a specified number of lines and replaces them with 
text you enter. You may enter as many new lines of text as you wish; S 
affects only how many lines are deleted. If no number is given, one line is 
deleted. For example, to delete four lines, including the current line, enter: 

4S 


This differs from the R command. The S command deletes the entire 
current line; the R command deletes text from the cursor onward . 


Replacing a Word: cw 

The cw command replaces a word with text you enter. For example, to 
replace the word “bear” with the word “fox”, move the cursor over the “b” 
in “bear”. Press: 

cw 


A dollar sign appears over the “r” in bear , marking the end of the text that 
is being replaced. Enter: 

fox 

and press ESC. The rest of “bear” disappears and only “fox” remains. 


Replacing the Rest of a Line: C 

The C command replaces text from the cursor to the end of the line. For 
example, to replace the text of the sentence: 

Who’s afraid of the big bad wolf? 
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from big to the end, move the cursor over the b in big and press: 

C 

A dollar sign ($) replaces the question mark (?) at the end of the line. Enter 
the following: 

little lamb? 

Press ESC. The remaining text from the original sentence disappears. 


Replacing a Whole Line: cc 

The cc command deletes a specified number of lines, regardless of the 
location of the cursor, and replaces them with text you enter. If no number 
is given, the current line is deleted. 


Replacing a Particular Word on a Line 

If a word occurs several times on one line, it is often convenient to use a 
line-oriented command to replace it. For example, to replace the word 
removing with “deleting” in the following sentence: 

In vi, removing a line is as easy as removing a letter. 


Make sure the cursor is at the beginning of that line, and enter: 
:s/ removing/deleting/g 


Press RETURN. This line-oriented command means “Substitute (s) for the 
word removing the word deleting , everywhere it occurs on the current line 
(g)”. If you don’t include a g at the end, only the first occurrence of remov- 
ing is changed. 

For more information on using line-oriented commands to replace text, 
see section 2.3. 19, “Searching and Replacing.” 
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2.3.17 Moving Text 

To move a block of text from one place in a file to another, you can use the 
line-oriented m command. You must know the line numbers of your file to 
use this command. The number option displays line numbers. To set this 
option, press ESC to make sure you are in Command mode, then enter: 

set number 


Line numbers will appear to the left of your text. For more information on 
setting the number option, see section 2.5.5, “Displaying Line Numbers: 
number”. 

The following example uses the number option. For other ways to display 
line numbers, see section 2.3.29, “Finding Out What Line You’re On”. 


1 [F]iles contain text. 

2 T ext contains lines. 

3 Lines contain characters. 

4 Characters form words. 

5 Words form text. 


To insert lines 2 and 3 between lines 4 and 5, enter: 
:2,3m4 
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Your screen should look like this: 


1 Files contain text. 

2 Characters form words. 

3 T ext contains lines. 

4 Lines contain characters. 

5 [W]ords form text. 


To place line 5 after line 2, enter: 
:5m2 


After moving, your screen should look like this : 


1 Files contain text. 

2 Characters form words. 

3 [Wjords form text. 

4Text contains lines. 

5 Lines contain characters. 


To make line 4 the first line in the file, enter: 
:4m0 
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Your screen should look like this: 


1 [T]ext contains lines. 

2 Files contain text. 

3 Characters form words. 

4 Words form text. 

5 Lines contain characters. 


You can also delete text into a temporary storage place, called a “buffer”, 
and insert it wherever you wish. When text is deleted it is placed in a 
“delete buffer”. There are nine “delete buffers”. 

The first buffer always contains the most recent deletion. In other words, 
the first deletion in a given editing session goes into buffer 1. The second 
deletion also goes into buffer 1, and pushes the contents of the old buffer 1 
into buffer 2. The third deletion goes into buffer 1, pushing the contents of 
buffer 2 into buffer 3, and the contents of buffer 1 into buffer 2. When 
buffer 9 has been used, the next deletion pushes the current text of buffer 9 
off the stack and it disappears. 

Text remains in the delete buffers until it is pushed off the stack, or until 
you quit the editor, so it is possible to delete text from one file, change files 
without leaving the editor, and place the deleted text in another file. 
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Delete buffers are particularly useful when you wish to remove text, store 
it, and put it somewhere else. Using the following text as an example: 


[Fjiles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Delete the first line by entering: 
dd 


Delete the third line the same way. Now move the cursor to the last line in 
the example and press: 

"IP 


The line from the second deletion appears: 


Text contains lines. 
Characters form words. 
Words form text. 

[Ljines contain characters. 
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Now enter: 

"2p 


The line from the first deletion appears: 


Text contains lines. 
Characters form words. 
Words form text. 

Lines contain characters. 
[F]iles contain text. 


Inserting text from a delete buffer does not remove the text from the buffer. 
Since the text remains in a buffer until it is either pushed off the stack or 
until you quit the editor, you may use it as many times as you wish. 

It is also possible to place text in named buffers. For information on how to 
create named buffers, see section 2.3.9, “Inserting Text From Other 
Files”. 


2.3. 18 Searching: / and ? 

You can search forward and backward for patterns in vi. To search for- 
ward, press the slash (/) key. The slash appears on the status line. Enter the 
characters you wish to search for. Press RETURN. If the specified pattern 
exists, the cursor will move to the first character of the pattern. 

For example, to search forward in the file for the word “account”, enter: 

/account 
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Press RETURN. The cursor is placed on the first character of the pattern. 
To place the cursor at the beginning of the line above “account”, for exam- 
ple, enter: 

/account/- 


To place the cursor at the beginning of the line two lines above the line that 
contains “account”, enter: 

/account/-2 


To place the cursor two lines below “account”, enter: 
/account/+2 


To search backward through a file, use ? instead of / to start the search. For 
example, to find all occurrences of “account” above the cursor, enter: 

?account 


To search for a pattern containing any of the special characters (. * \ [ ] ~ $ 
and ), each special character must be preceded by a backslash. For exam- 
ple, to find the pattern “U.S.A.”, enter: 

/U\.S\.A\./ 


You can continue to search for a pattern by pressing: 
n 


after each search. The pattern is unaffected by intervening vi commands, 
and you can use n to search for the pattern until you enter a new pattern or 
quit the editor. 

vi searches for exactly what you enter. If the pattern you are searching for 
contains an uppercase letter (for example, if it appears at the b eginning of a 
sentence), vi ignores it. To disregard case in a search command, you can 
set the ignorecase option : 

:set ignorecase 
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By default, searches “wrap around” the file. That is, if a search starts in the 
middle of a file, when vi reaches the end of the file it will “wrap around” to 
the beginning, and continue until it returns to where the search began. 
Searches will be completed faster if you specify forward or backward 
searches, depending on where you think the pattern is. 

If you do not want searches to wrap around the file, you can change the 
“wrapscan” option setting. Enter: 

:set nowrapscan 


and press RETURN to prevent searches from wrapping. For more informa- 
tion about setting options, see section 2.5, “Setting Up Your Environ- 
ment”. 


2.3.19 Searching and Replacing 

The search and replace commands allow you to perform complex changes 
to a file in a single command. Learning how to use these commands is a 
must for the serious user of vi. 

The syntax of a search and replace command is: 

g / pa ttern l/s/\pa ttern2 ]/ [options] 


Brackets indicate optional parts of the command line. The g tells the com- 
puter to execute the replacement on every line in the file. Otherwise the 
replacement would occur only on the current line. The options are 
explained in the following sections. 
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To explain these commands we will use the example file from the demons- 
tration run: 


[F]iles contain text. 

Text contains lines. 

Lines contain characters. 
Characters form words. 
Words form text. 


Replacing a Word 

To replace the word “contain” with the word “are” throughout the file, 
enter the following command : 

:g/contain /s//are /g 


This command says “On each line of the file (g), find contain and substi- 
tute for that word (s//) the word are, everywhere it occurs on that line (the 
second g)”. Note that a space is included in the search pattern for contain ; 
without the space contains would also be replaced. 
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After the command executes your screen should look like this: 


[FJiles are text. 

Text contains lines. 
Lines are characters. 
Characters form words. 
Words form text. 


Printing all Replacements 

To replace “contain” with “are” throughout the file, and print every line 
changed, use the p option: 

:g/contain /s//are /gp 


Press RETURN. After the command executes, each line in which “con- 
tain” was replaced by “are” is printed on the lower part of the screen. To 
remove these lines, redraw the screen by pressing Ctrl- 1. 


Choosing a Replacement 

Sometimes you may not want to replace every instance of a given pattern. 
The c option displays every occurrence of pattern and waits for you to 
confirm that you want to make the substitution. If you press y the substitu- 
tion takes place; if you press RETURN the next instance of pattern is 
displayed. 

To run this command on the example file, enter: 

:g/contain/s//are/gc 
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Press RETURN. The first instance of “contain” appears on the status line: 
Files containtext. 

Press y , then RETURN. The next occurrence of contain appears. 


2.3.20 Pattern Matching 

Search commmands often require, in addition to the characters you want 
to find, a context in which you want to find them. For example, you may 
want to locate every occurrence of a word at the beginning of a line, vi pro- 
vides several special characters that specify particular contexts. 


Matching the Beginning of a Line 

When a caretO is placed at the beginning of a pattern, only patterns found 
at the beginning of a line are matched. For example, the following search 
pattern only finds “text” when it occurs as the first word on a line: 

/"text/ 


To search for a caret that appears as text you must precede it with a 
backslash (\). 


Matching the End of a Line 

When a dollar sign ($) is placed at the end of a pattern, only patterns found 
at the end of a line are matched. For example, the following search pattern 
only finds “text” when it occurs as the last word on a line: 

/text$/ 

To search for a dollar sign that appears as text you must precede it with a 
backslash (\). 
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Matching Any Single Character 

When used in a search pattern, the period (.) matches any single character 
except the newline character. For example, to find all words that end with 
“ed”, use the following pattern: 

/.ed / 

Note the space between the d and the b ackslash . 

To search for a period in the text, you must precede it with a backslash (\). 

Matching a Range of Characters 

A set of characters enclosed in square brackets matches any single charac- 
ter in the range designated . For example, the search pattern : 

/[a-z]/ 

finds any lowercase letter. The search pattern: 

/[aA]pple/ 

finds all occurrences of “apple” and “Apple”. 

To search for a bracket that appears as text, you must precede it with a 
backslash (\). 

Matching Exceptions 

A caret ( ) at the beginning of string matches every character except those 
specified in string. For example the search pattern: 

fa-z] 

finds anything but a lowercase letter or a newline. 

Matching the Special Characters 

To place a caret, hyphen or square bracket in a search pattern, precede it 
with a backslash. To search for a caret, for example, enter: 

A7 


2-44 



vi: A Text Editor 


If you need to search for many patterns that contain special characters, you 
can reset the magic option. To do this, enter: 

:nomagic 


This removes the special meaning from the characters ., \, $, [ and ]. You 
can include them in search and replace commands without a preceding 
backslash. Note that the special meaning cannot be removed from the spe- 
cial characters star (*) and caret f ); these must always be preceded by a 
backslash in searches. 

To restore magic, enter: 

:set magic 


For more information about setting options, see section 2.5, “Setting Up 
Your Environment”. 


2.3.21 Undoings Command: u 

Any editing command can be reversed with the Undo (u) command. The 
Undo command works on both screen -oriented and line-oriented com- 
mands. For example, if you have deleted a line and then decide you wish to 
keep it, press u and the line will reappear. 

Use the following line as an example: 


[T]ext contains lines. 
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Place the cursor over the “c” in “contains”, then delete the word with the 
dw command. Your screen should look like this: 



Press u to undo the dw command, contains reappears: 



2-46 





vi: A Text Editor 


If you press u again, “contains” is deleted again : 


Text [l]ines. 


It is important to remember that u only undoes the last command. For 
example, if you make a global search and replace, then delete a few charac- 
ters with the x command, pressing u will undo the deletions but not the glo- 
bal search and replace. 


2.3.22 Repeating a Command: . 

Any screen-oriented vi command can be repeated with the Repeat (.) 
command. For example, if you have deleted two words by entering: 

2dw 


you may repeat this command as many times as you wish by pressing the 
period key (.). Cursor movement does not affect the Repeat command, so 
you may repeat a command as many times and in as many places in a file as 
you wish. 

The Repeat command only repeats the last vi command. Careful planning 
can save time and effort. For example, if you want to replace a word that 
occurs several times in a file (and for some reason you do not wish to use a 
global command), use the cw command instead of deleting the word with 
the dw command, then inserting new text with the i command. By using the 
cw command you can repeat the replacement with the dot (.) command. If 
you delete the word, then insert new text, dot only repeats the replace- 
ment. 
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2.3.23 Leaving the Editor 

There are several ways to exit the editor and save any changes you may have 
made to the file. One way is to enter: 


:x 


and press RETURN. This command replaces the old copy of the file with 
the new one you have just edited, quits the editor, and returns you to the 
XENIX shell. Similarly, if you enter: 

ZZ 


the same thing happens, except the old copy file is written out only if you 
have made any changes. Note that the ZZ command is not preceded by a 
colon, and is not echoed on the screen. 

To leave the editor without saving any changes you have made to the file, 
enter: 


:q! 


The exclamation point tells vi to quit unconditionally. If you leave out the 
exclamation point: 

•q 


vi will not let you quit. You will see the error message: 
No write since last change (:quit! overrides) 


This message tells you to use :ql if you really want to leave the editor 
without saving your file. 


Saving a File Without Leaving the Editor 

There are many occasions when you must save a file without leaving the 
editor, such as when starting a new shell, or moving to another file. Before 
you can perform these tasks you must first save the current file with the 
Write (:w) command: 


:w 
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You do not need to enter the name of the file; vi remembers the name you 
used when you invoked the editor. If you invoked vi without a filename, 
you may name the file by entering: 

:w filename 

where filename is the name of the new file. 


2.3.24 Editing a Series of Files 

Entering and leaving vi for each new file takes time, particularly on a 
heavily used system, or when you are editing large files. If you have many 
files to edit in one session, you can invoke vi with more than one filename, 
and thus edit more than one file without leaving the editor, as in : 

vi filel file2 file3 file4 file5 file6 


But entering many filenames is tedious, and you may make a mistake. If 
you mistype a filename, you must either backspace over to mistake and 
reenter the line, or kill the whole line and reenter it. It is more convenient 
to invoke vi using the special characters as abbreviations. 

To invoke vi on the above files without typing each name, enter: 

vi file* 


This invokes vi on all files that begin with the letters “file”. You can plan 
your filenames to save time in later editing. For example, if you are writing a 
document that consists of many files, it would be wise to give each file the 
same filename extension, such as “.s”. Then you can invoke vi on the 
entire document: 

vi *.s 


You can also invoke vi on a selected range of files: 
vi [3-5]*. s 


or 


vi [a-h]* 
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To invoke vi on all files that are five letters long, and have any extension: 
vi ?????.* 


For more information on using special characters, see Chapter 3 of the 
Introduction to XENIX manual, section 3.3.4, “Special Characters”. 

When you invoke vi with more than one filename, you will see the following 
message when the first file is displayed on the screen : 

x files to edit 


After you have finished editing a file, save it with the Write (:w) command, 
then go to the next file with the Next (:n) command : 

:n 


The next file appears, ready to edit. It is not necessary to specify a 
filename; the files are invoked in alphabetical (or numerical, if the 
filenames begin with numbers) order. 

If you forget what files you are editing, enter: 

:args 


The list of files appears on the status line. The current file is enclosed in 
square brackets. 

To edit a file out of order, such as file4 after file2, enter: 

:e file4 

instead of using the (:n) command. If you enter: 

:n 

after you finish editing file4 } you will go b ack to file3. 

If you wish to start again from the beginning of the list, enter: 

:rew 
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To discard the changes you made and start again at the beginning, enter: 
:rew! 


2.3.25 Editing a New File Without Leaving the Editor 

You can start editing another file anywhere on the XENIX system without 
leaving vi. This saves time when you wish to edit several files in one session 
that are in different directories, or even in the same directory. For exam- 
ple, if you have finished editing lusrljoelmemo and you wish to edit 
/usr /mary / letter , first save the file memo with the Write (:w) command then 
enter: 


:e /usr/mary/letter 

/ usr f mary f letter appears on your screen just as though you had left vi. 


Note 

You must write out your file with the Write (:w) command to save the 
changes you have made. If you try to edit a second file without writing 
out the first file, the message “No write since last change (:e! over- 
rides)” appears. If you use :e! all your changes to the first file are dis- 
carded. 


If you want to switch back and forth between two files, vi remembers the 
name of the last file edited. Using the above example, if you wish to go 
back and edit the file lusrljoelmemo after you have finished with 
I usr! mary! letter, enter: 

:e# 

The cursor is positioned in the same location it was when you first saved 
lusrljoelmemo. 
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2.3.26 Leaving the Editor Temporarily: Shell Escapes 

You can execute any XENIX command from within vi using the shell 
Escape (!) command. For example, if you wish to find out the date and 
time, enter: 

:!date 

The exclamation point sends the remainder of the line to the shell to be 
executed, and the date and time appear on the vi status line. You can use 
the ! to perform any XENIX command. To send mail to joe without leaving 
the editor, enter: 

:!mail joe 

Type your message and send it. (For more information about the XENIX 
mail system, see Chapter 3, “mail”.) After you send it, the message 

[Hit return to continue] 

appears. Press RETURN to continue editing. 

If you want to perform several XENIX commands before returning to the 
editor, you can invoke a new shell: 

:!sh 

The XENIX prompt appears. You may execute as many commands as you 
like. Press Ctrl- d to terminate the new shell and return to your file. 

If you have not written out your file before a shell escape, you will see the 
message: 

[No write since last change] 

It is a good idea to save your file with the Write (:w) command before exe- 
cuting an escape, just in case something goes wrong. However, once you 
become an experienced vi user, you may wish to turn off this message. To 
turn off the “No write” message, reset the warn option, as follows: 

:set nowam 

For more information about setting options in vi, see section 2.5, “Setting 
Up Your Environment”. 


2-52 



vi: A Text Editor 


2.3.27 Performing a Series of Line- Oriented Commands : Q 

If you have several line-oriented commands to perform, you can place 
yourself temporarily in Line-oriented mode by entering: 

Q 

while you are in Command mode. A colon prompt appears on the status 
line. 

Commands executed in this mode cannot be undone with the u command, 
nor do they appear on the screen until you re-enter Normal vi mode. To 
re-enter Normal vi mode, enter: 

vi 


2.3.28 Finding Out What File You’re In 

If you forget what file you are editing, press Ctrl- g while you are in Com- 
mand mode. A line similar to the following appears appears on the status 
fine: 


“memo” [Modified] line 12 of 100 — 12% — 

From left to right, the following information is displayed: 

- The name of the file 

- Whether or not the file has been modified 

- The line number the cursor is on 

- How many lines there are in the file 

- Your location in the file (expressed as a percentage) 

This command is also useful when you need to know the line number of the 
current line for a line-oriented command. 

The same information can be obtained by entering: 

:file 


or 


:f 
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2.3.29 Finding Out What Line You ’re On 

To find out what line of the file you are on, enter: 

:nu 

and press RETURN. This command displays the current line number and 
the text of the line. 

To display line numbers for the entire file, see section 2.5.5, “Displaying 
Line Numbers: number” 


2.4 Solving Common Problems 

The following is a list of common problems that you may encounter when 
using vi, along with the probable solution. 

- I don 't know which mode I'm in. 

Press ESC until the bell rings. When the bell rings you are in Com- 
mand mode. 

- lean ’t get out of a subshell. 

Press Ctrl- d to exit any sub shell. If you have created more than one 
sub shell (not a good idea, usually), keep pressing Ctrl-d until you 
see the message: 

[Hit return to continue] 

- I made an inadvertent deletion (or insertion ). 

Press u to undo the last Delete or Insert command. 

- There are extra characters on my screen. 

Press Ctrl- 1 to redraw the screen. 

- When I type , nothing happens. 

vi has crashed and you are now in the shell with your terminal 
characteristics set incorrectly. To reset the keyboard, slowly enter: 

stty sane 
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not work as a newline character. To make sure that other terminal 
characteristics have not been altered, log off, turn your terminal off, 
turn your terminal back on, and then log back in. This should 
guarantee that your terminal’s characteristics are back to normal. 
This procedure may vary somewhat depending on the terminal. 

- The system crashed while I was editing. 

Normally, vi will inform you (b> sending you mail) that your file has 
been saved before a crash. The file can be recovered by entering: 

vi -r filename 

If vi was unable to save the file before the crash, it is irretrievably 
lost. 

- I keep getting a colon on the sta tus line when I press RETURN 
You are in line-oriented Command mode. Enter: 

vi 

to return to normal vi Command mode. 

- I get the error message “Unknown terminal type [Using open mode] ” 
when I invoke vi. 

Your terminal type is not set correctly. To leave Open mode, press 
ESC, then enter: 

:wq 

and press RETURN. Turn to section 2.5.1, “Setting the Terminal 
Type” for information on how to set your terminal type correctly. 


2.5 SettingUp Your Environment 

There are a number of options that can be set that affect your terminal 
type, how files and error messages are displayed on your screen, and how 
searches are performed. These options can be set with the set command 
while you are editing, or they can be placed in the vi startup file, .exrc. (The 
.exrc file is explained in section 2.5. 13.) The following sections describe the 
most commonly used options and how to set them. There is a complete list 
of options in vi(C) in the XENIX Reference Manual. 
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2.5.1 Setting the Terminal Type 

Before you can use vi, you must set the terminal type, if this has not already 
been done for you, by defining the TERM variable in your .profile file. (The 
. profile file is explained in the XENIX User’s Guide.) The TERM variable is 
a number that tells the operating system what type of terminal you are 
using. To determine this number you must find out what type of terminal 
you are using. Then look up this type in Terminals(M) in the XENIX Refer- 
ence Manual. If you cannot find your terminal type or its number, consult 
your System Administrator. 

For these examples, we will suppose that you are using an HP 2621 termi- 
nal. For the HP 2621, the TERM variable is “2621”. How you define this 
variable depends on which shell you are using. You can usually determine 
which shell you are using by examining the prompt character. The Bourne 
shell prompts with a dollar sign ($) ; the C- shell prompts with a percent sign 
(%). 


Setting the TERM variable: The Visual Shell 

If you are using the Visual Shell the terminal type has already been set, and 
you do not need to change it. 


Setting the TERM variable:The Bourne Shell 

To set your terminal type to 2621 place the following commands in the file 
.profile: 

TERM=2621 
export TERM 


Setting the TERM variable: The C Shell 

To set your terminal type to 2621 for the C shell, place the following com- 
mand in the file .login: 

setenv TERM 2621 


2.5.2 Setting Options: The set Command 

The set command is used to display option settings and to set options. 
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Listing the Available Options 

To get a list of the options available to you and how they are set, enter: 
:set all 

Your display should look similar to this: 


noautoindent 

autoprint 

no auto write 

nobeautify 

directory=/tmp 

noerrorbells 

hardtabs=8 

noignorecase 

nolisp 

nolist 

magic 

nonumber 


open 

nooptimize 

paragraphs=IPLPPPQPP LIbp 

noprompt 

noreadonly 

redraw 

report=5 

scroll=4 

sections=NHSHH HU 
shell=/bin/sh 
shiftwidth=8 
noshowmatch 


noslowopen 

tabstop=8 

taglength=0 

ttytype=hl9 

term=hl9 

noterse 

warn 

window=8 
wrap sc an 
wrap mar gin=0 
nowriteany 


This chapter discusses only the most commonly used options. For infor- 
mation about the options not covered in this chapter, see vi(C) in the 
XENIX Reference Manual. 


Setting an Option 

To set an option, use the set command. For example, to set the ignorecase 
option so that case is not ignored in searches, enter: 

set noignorecase 


2.5.3 Displaying Tabs and End- of- Line: list 

The list option causes the “hidden” characters and end-of-line to be 
displayed. The default settingis nolist. To display these characters, enter: 

:set list 

Your screen is redrawn. The dollar sign ($) represents end-of-line and 
Ctrl-i (I) represents the tab character. 
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2.5.4 Ignoring Case in Search Commands : ignorecase 

By default, case is significant in search commands. To disregard case in 
searches, enter: 

:set ignorecase 

To change this option, enter: 

:set noignorecase 

2.5.5 Displaying Line Numbers: number 

It is often useful to know the line numbers of a file. To display these 
numbers, enter: 

:set number 

This redraws your screen. Numbers appear to the left of the text. To 
remove line numbers, enter: 

:set nonumber 


2.5.6 Printing the Numberof Lines Changed: report 

The report option tells you the number of lines modified by a line-oriented 
command. For example, 

:set report=l 

reports the number of lines modified, if more than one line is changed. The 
default setting is: 

report=5 

which reports the number of lines changed when more than five lines are 
modified. 


2.5.7 Changing the Terminal Type:term 

If you are logged in on a terminal that is a different type than the one you 
normally use, you can check the terminal type setting by entering: 

:set term 
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Press RETURN. See section 2.5.1, “Setting the Terminal Type” for more 
information about TERM variables. 


2.5.8 Shortening Error Mess ages: terse 

After you become experienced with vi, you may want to shorten your error 
messages. To change from the default noterse, enter: 

:set terse 

As an example of the effect of terse, when terse is set the message: 

No write since last change, quit! overrides 
becomes: 

No write 


2.5.9 Turning Off Warnings: warn 

After you become experienced with vi, you may want to turn off the error 
message that appears if you have not written out your file before a Shell 
Escape (:!) command. To turn these messages off, enter: 

:set nowam 


2.5. 10 Permitting Special Characters in Searches: nomagic 

The nomagic option allows the inclusion of the special characters (. \ $ [ ]) 
in search patterns without a preceding backslash. This option does not 
affect caret O or star (*); they must be preceded by a backslash in searches 
regardless of magic. To set nomagic, enter: 

:set nomagic 


2.5.11 Limiting Searches: wrapscan 

By default, searches in vi “wrap” around the file until they return to the 
place they started. To save time you may want to disable this feature. Use 
the following command : 

:set nowrapscan 
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When this option is set, forward searches go only to the end of the file, and 
backward searches stop at the beginning. 


2.5.12 Turning on Messages: mesg 

If someone sends you a message with the write command while you are in vi 
the text of the message will appear on your screen. To remove the message 
from your display you must press Ctrl- 1. When you invoke vi, write permis- 
sion to your screen is automatically turned off, preventing write messages 
from appearing. If you wish to receive write messages while in vi, reset this 
option as follows: 

rsetmesg 


2.5.13 Customizing Your Environment: The .exrcFile 

Each time vi is invoked, it reads commands from the file named .exrc in 
your home directory. This file sets your preferred options so that they do 
not need to be set each time you invoke vi. A sample . exrc file follows: 

set number 
set ignorecase 
set nowam 
set report=l 


Each time you invoke vi with the above options, your file is displayed with 
line numbers, case is ignored in searches, warnings before shell escape 
commands are turned off, and any command that modifies more than one 
line will display a message indicating how many lines were changed . 
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2.6 Summary of Commands 

The following tables contain all the basic commands discussed in this 
chapter. 


Entering vi 


Typing this: 

Does this: 

vi file 

Starts at line 1 

vi +n file 

Starts at line n 

vi + file 

Starts last line 

vi -f/pattem file 

Starts at pattern 

vi -r file 

Recovers file after a sys- 
tem crash 
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Curs or Movement 


Pressing this key: 

Does this: 

h 

1 

SPACEBAR 

Moves 1 space left 

Moves 1 space right 

Moves 1 space right 

w 

b 

Moves 1 word right 

Moves 1 word left 

k 

j 

RETURN 

Moves 1 line up 

Moves 1 line down 

Moves 1 line down 

) 

( 

Moves to end of sentence 

Moves to beginning of sentence 

} 

{ 

Moves to beginning of paragraph 
Moves to end of paragraph 

Ctrl-w 

Moves to first character of inser- 
tion 

Ctrl-u 

Scrolls up 1/2 screen 

Ctrl-d 

Scrolls down 1/2 screen 

Ctrl-f 

Scrolls down one screen 

Ctrl-b 

Scrolls up one screen 
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Inserting Text 


Pressing 

Starts insertion: 

i 

Before the cursor 

I 

Before first character on the line 

a 

After the cursor 

A 

After last character on the line 

o 

On next line down 

O 

On the line above 

r 

On current character, replaces 
one character only 

R 

On current character, replaces 
until ESC 

Delete Commands 

Command 

Function 


dw 

Deletes a word 


dO 

Deletes to beginning of line 


d$ 

Deletes to end of line 


3dw 

Deletes 3 words 


dd 

Deletes the current line 


5dd 

Deletes 5 lines 


X 

Deletes a character 
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Change Commands 


Command 

Function 

cw 

Changes 1 word 

3cw 

Changes 3 words 

cc 

Changes current line 

5cc 

Changes 5 lines 

Search Commands 


Command 

Function 

Example 

/and 

Finds the next 
occurrence of and 

and, stand, grand 

?and 

Finds the previous 
occurrence of and 

and, stand, grand 

/"The 

Finds next line 
that starts with 
The 

The, Then, There 

/[bBjox/ 

Finds the next 
occurrence of box 
or Box 


n 

Repeats the most 
recent search, in 
the same direction 
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Search and Replace Commands 


Command 

:s/pear/peach/g 

:l,$s/file/directory 

:g/one/s//l/g 


Result 

All pears, become 
peach on the 
current line 

Replaces file with 
directory from line 
lto the end. 

Replaces every 
occurrence of one 
with 1. 


Example 


filename becomes 
directory name 


one becomes 1, 
oneself becomes 
lself, someone 
becomes somel 


Pattern Matching: Special Characters 


This character: 

Matches: 

* 

Beginning of a line 

$ 

End of a line 

• 

Any single character 

[] 

A range of characters 
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Leaving vi 


Command 

Result 

:w 

Writes out the file 

:x 

Writes out the file, quits 
vi 

:q! 

Quits vi without saving 
changes 

:!command 

Executes command 

:!sh 

Forks a new shell 

Mcommand 

Executes command and 
places output on current 
line 

:e file 

Edits file (save current 
file with :w first) 
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Options 


This option: 

Does this: 

an 

Lists all options 

term 

Sets terminal type 

ignorecase 

Ignores case in searches 

list 

Displays tab and end-of-line characters 

number 

Displays line numbers 

report 

Prints number of lines changed by a line-oriented command 

terse 

Shortens error messages 

warn 

Turns off “no write” warning before escape 

nomagic 

Allows inclusion of special characters in search patterns 
without a preceding backslash 

nowrapscan 

Prevents searches from wrapping around the end or 
beginning of a file. 

mesg 

Permits display of messages sent to your terminal with 
the write command 
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3.1 Introduction 


The XENIX mail system is a versatile communication facility that allows 
XENIX users to compose, send, receive, forward, and reply to mail. Users 
can also create distribution groups and send copies of messages to multiple 
users. These functions are integrated into XENIX so that all users can 
quickly and easily communicate with each other. 

This chapter is organized to satisfy the needs of both the beginning and 
advanced user. The first sections discuss basic concepts, tasks, and com- 
mands. Later sections discuss advanced topics and provide quick refer- 
ence to the mail program’s many functions. The major sections in this 
chapter are: 

Demonstration 

Basic Concepts 


Using mail 


Commands 


Shows new users how to get started. 

Discusses the fundamental ideas and termi- 
nology used in mail. 

Shows how to perform common mailing pro- 
cedures such as composing, sending, for- 
warding, and replying to mail. 

Discusses each mail command. 


Leaving Compose Mode Temporarily 

Discusses and gives examples of each com- 
mand available when composing a message. 
These commands are called “compose 
escapes.” 

Setting Up Your Environment 

Discusses the user’s mail startup file and 
options that may be set to customize func- 
tions. 


Using Advanced Features 

Discusses advanced features such as using 
mail as a reminder service and handling a 
large volume of mail. 

Quick Reference Summarizes all commands, compose 

escapes, and options. 
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3.2 Demonstration 

The mail command lets you perform two distinct functions: sending mail 
and disposing of mail. In this demonstration, we will show you how to send 
mail to yourself, read a message, delete it, and exit the mail program. 

3.2.1 Composing and Sending a Message 

To begin, enter: 
mail self 

where self is your user name. Next, enter the following lines. Press 
RETURN at the end of each line. 

This is a message sent to myself. 

I compose a message by entering lines of text. 

Press Ctrl-d on a newline to end the message. 

As you enter the message you can use “compose escapes 5 ’ to perform spe- 
cial functions. To get a list of the available compose escapes, enter: 

~? 

on a new line. To specify a subject, use the ~s escape. For example, enter: 

~s Sample subject 

To specify a list of people to receive carbon copies use the ~c escape For 
example, enter: 

~c abel 


To view the message as it will appear when you send it, enter: 
~P 

This will display the following: 

Message contains: 

To: self 

Subject: Sample subject 
Cc: abel 

This is a message sent to myself. 

I compose a message by entering lines of text. 

Press Ctrl-d on a newline to end the message. 
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Finally, press Ctrl-d by itself on a line, to end the message and send it to 
those that you have mentioned in the To: and the Cc: fields. You will exit 
from the mail program and return to the XENIX shell. Once you have sent 
mail, there is no way to undo the act, so be careful. 


3.2.2 Reading mail 

Within a short time, you should receive the message: 

You have mail. 

(You must press RETURN before this message will appear on your screen.) 
This message informs you that the message you have just sent has arrived in 
your system mailbox. To read this message and any others that may have 
been sent to you, enter: 

mail 

mail then displays a sign -on message and a list of message headers that 
look something like this: 

Mail version 3.0 August 30, 1985. Type ? for help. 

1 message: 

lself FriAug31 12:26 7/188 “Sample subject” 


When there is more than one message in your mailbox, the most recent 
message is displayed at the top of the list. The message at the top of the list 
has the highest number. The messages are numbered in ascending order 
from least recent to most recent. The message header includes who sent 
the message, when it was sent, the number of lines and characters, and the 
subject of the message. The underscore prompt prompts you to enter a 
mail command. Now enter: 

? 

to get help on all the available mail commands. Next, enter: 

P 

to see the message that you sent to yourself, mail displays the following: 
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>From self Fri Aug 20 12:26:52 1985 
To: self 

Subject: Sample subject 

This is a message sent to myself. 

I compose a message by entering lines of text. 
Press Ctrl-d on a newline to end the message. 


Note that the message you sent to yourself now contains information about 
the sender of the message-a line telling who sent the message and when it 
was sent. The next line tells who the message was sent to. A subject and 
carbon copy (Cc:) field can be specified by the sender. If they are present, 
they too are displayed when you read the message. 


3.2.3 Leaving mail 

If this message has no real use, you can delete it by entering: 
d 

To get out of mail, enter: 

q 

mail then displays the message 

0 messages held in / usr/ spool/mail/ self 
and returns you to the XENIX shell. 

This ends the demonstration. For more detailed information, see the dis- 
cussions in the following sections. 

3.3 Basic Concepts 

It is much easier to use mail if you understand the basic concepts that 
underlie it. The concepts discussed in this section are: 

- mailboxes 

- Messages 
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3.3.1 mailboxes 

It is useful to think of the mail system as modeled after a typical postal sys- 
tem. What is normally called a post office is called the “system mailbox” in 
this chapter. The system mailbox contains a file for each user in the direc- 
tory lusrl spool/ mail. Your own personal or “user mailbox” is the file 
named mbox in your home directory, mail sent to you is put in your system 
mailbox; you may choose to save mail in your user mailbox after you have 
read it. Note that the user mailbox differs from a real mailbox in several 
respects: 

1. You decide whether mail is to be placed in the user mailbox; it is not 
automatically placed there. 

2. The user mailbox is not the place where mail is initially routed-that 
place is the system mailbox in the directory lusrl spool! mail. 

3. mail is not picked up from your user mailbox. 


3.3.2 Messages 


In mail, the message is the basic unit of exchange between users. Messages 
consist of two parts: a heading and a body. The heading contains the fol- 
lowing fields: 

To: This field is mandatory. It contains one or more valid user 

names to which you may send mail. 

Subject: This optional field contains text describing the message. 

Cc: The carbon copy field contains one or more valid names of 

those who are to receive copies of a message. Message reci- 
pients see these names in the received message. This field 
can be empty. 


Bcc: The blind carbon copy field contains the one or more valid 

names of people who are to receive copies of a message. 
Recipients do not see these names in the received messages. 
This field can be empty. 


Return -receipt -to: 

The return receipt to: field contains the valid name or 
names of those who are to receive an automatic ack- 
nowledgement of the message. This field can be empty. 

The body of a message is text exclusive of the heading. The body can be 
empty. 
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3.3.3 Modes 

Often, the biggest hurdle to using mail is understanding what modes of 
operation are available. This section discusses each mode. 

When you invoke mail you are using the shell. If you want to mail a letter 
without entering mail command mode, you can do so by entering: 

mail john < letter 

Here, the file letter is sent to the user john . 


Note 

Be very careful when mailing a file with the input redirection symbol 
(<). If you accidentally enter the output redirection symbol (>), you 
will overwrite the file, destroying its contents. 


You can enter a message from your shell by entering: 
mail john 

Next, enter the text of your message as follows : 

This is the text of the message. 

Press RETURN to start a new line, then Ctrl-d to send the message. 

Messages such as the one above are created in mail’s compose mode. 
When entering text in compose mode, there are several special keys associ- 
ated with line editing functions: these are the same special characters that 
are available to you when executing normal XENIX commands. For exam- 
ple, you can kill the line you are editing by entering Ctrl-u, normally the kill 
character. To backspace, press the BACKSPACE Key or Ctrl-h. 

From compose mode, you can issue commands called compose escapes. 
These are also called tilde escapes because the command letters are pre- 
ceded by a tilde (~). When you execute these commands you are tem- 
porarily leaving or escaping from compose mode; hence the name. Note 
that once you have pressed RETURN to end a line, you cannot change that 
line from within compose mode. You must enter edit mode in order to 
change that line. 

The most common way of using mail is to just enter: 
mail 


3-6 



mail 


This automatically places you in mail command mode. In this mode, you 
are prompted by an underscore for commands that permit you to manage 
your mail. 

You can enter edit mode from either compose mode or command mode. 
In edit mode, you edit the body of a message using the full capabilities of an 
editor. To enter edit mode from command mode, use either the e or edit 
command to enter ed, or the v or visual command to enter vi. ( Vi may not 
be available on your system.) To enter edit mode from compose mode, use 
the compose escapes ~e and ~v, respectively. 


3.3.4 Message- Lists 

Many mail commands take a list of messages as an argument. A message- 
list is a list of message numbers, ranges, and names, separated by spaces or 
tabs. Message numbers may be either decimal numbers, which directly 
specify messages, or one of the special characters ~ , . , or $ , which specify 
the first, current, or last undeleted message, respectively. Here, relevant 
means not deleted. 

A range of messages is two message numbers separated by a dash. To 
display the first four messages on the screen, enter: 

p 1-4 

To display all the messages from the current message to the last message, 
enter: 


p .-$ 


A name is a user name. Messages can be displayed by specifying the name 
of the sender. For example, to display each message sent to you by john, 
enter: 


pjohn 


Asa shorthand notation, you can specify star (*) to get all undeleted mes- 
sages. For example, to display all messages except those that have been 
deleted, enter: 

P 

To delete all messages, enter: 
d 
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To delete all messages, enter: 
u 

All three of these commands are described later in detail in Section 3.5, 
“Commands.”) 


3.3.5 Headers 

When you enter mail, a list of message headers is displayed. A header is a 
single line of text containing descriptive information about a message. 
(Note that we use the word heading to describe the first part of a message, 
and header to describe mail’s one-line description of a message.) The 
information includes: 

- The number of the message 

- The sender 

- The date sent 

- The number of characters and lines 

- The subject (if the message contains a Subject: field) 

Message headers are displayed in windows with the headers command. A 
header window contains no more than 18 headers. E there are fewer than 
18 messages in the mailbox, all are displayed in one header window. E 
there are more than 18 messages, then the list is divided into an appropriate 
number of windows. You can move forward one window at a time with the 
command: 

headers + 

and move b ackward one window at a time with the command : 

headers - 
commands. 


3.3.6 Command Syntax 

Each mail command has its own syntax. Some take no arguments, some 
take only one, and others take several arguments. The more flexible com- 
mands, such as print, accept combinations of message-lists and user 
names. For these commands, mail first gathers all message numbers and 
ranges, then finds all messages from any specified user names. The full 
message-list is the intersection of these two sets of messages. Thus, the 
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message-list “4-15 miller” matches all messages between 4 and 15 that are 
from miller. 

Each mail command is entered on a line by itself, and any arguments fol- 
low the command word. The command need not be entered in its 
entirety-the first command that matches the entered prefix is used. For 
example, you can enter “p” instead of “print” for the print command and 
“h” instead of “headers” for the headers command. 

After the command itself is entered, one or more spaces should be entered 
to separate the command from its arguments. If a mail command does not 
take arguments, any arguments you give are ignored and no error occurs. 
For commands that take message-lists as arguments, if no message-list is 
given, the last message printed is used. If it does not satisfy the require- 
ments of the command, the search proceeds forward. If there are no mes- 
sages ahead of the current message, the search proceeds backwards, and if 
there are no valid messages at all, mail displays: 

No applicable messages 


3.4 Using mail 

This section describes how to perform some basic tasks when using mail. 
More detailed discussions of each of these commands are presented in 
later sections. 


3.4.1 Entering and Exiting mail 

To begin a session with mail, enter: 
mail 

The headers for each received message are then displayed one screenful at 
a time. To display the next screenful of headers (if any), enter: 

h+ 

To end the mail session, use the quit (q) command. All messages remain 
in the system mailbox unless they have been deleted with the delete ( d ) 
command, saved with the save or write command, or held in your user 
mailbox with the mbox command. Deleted messages are discarded. The 
— f command line option causes mail to read in the contents of mbox. 
Optionally, a filename may be given as an argument to — f, so that the 
specified file is read instead. When you quit, mail writes all messages back 
to this file. 
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If you send mail over a noisy phone line, you will notice that many of the 
bad characters turn out to be RUBOUT or DEL character. These charac- 
ters cause mail to abort messages. To deal with this annoyance, you can 
invoke mail with the -i option which causes these bad characters to be 
ignored. 


3.4.2 Sending mail 

To send a message, invoke mail with the names of the people and groups 
you want to receive the message. Next, enter your message. When you are 
finished, press Ctrl-d at the beginning of a line. The message is automati- 
cally sent to the specified people. While entering the text of your message, 
you can escape to an editor or perform other useful functions with com- 
pose escapes. Section 3.4.5, “Composing mail,” describes some features 
of mail available to help you when composing messages. 

If you have a file that contains a written message, you can send it to sam, 
bob, and john by entering: 

mail sam bob john < letter 

where letter is the name of the file you are sending. 


Note 

Be very careful when mailing a file with the input redirection symbol 
(<). If you accidentally enter the output redirection symbol (>), you 
will overwrite the file, destroying its contents. 


If mail cannot be delivered to a specified address, you will either be 
notified immediately, in which case a copy of the undeliverable message is 
appended to the file dead, letter , or you will be notified via return mail, in 
which case a copy is included in the return mail message. 


3.4.3 Reading mail 

To read messages sent to you, enter: 
mail 

mail then checks your mail out of the system mailbox and prints out a one- 
line header of each message, one screenful at a time. Enter “h+” to view 
the next screenful. The most recent message is initially the first message 
(numbered highest, because messages are numbered chronologically) and 
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may be printed using the print command. You can move forward one mes- 
sage by pressing RETURN or entering To move forward n messages 
use You can move backwards one message with the command 

or move backwards n messages and print with You can also move to 

any arbitrary message and print it by entering its number. 

If new messages arrive while you are in mail, the following message 
appears: 

New mail has arrived --type ‘restart’ to read. 


Enter: 


restart 

and the headers of the new messages are displayed. 


3.4.4 Disposing of mail 

After examining a message you can delete it with the delete ( d ) command, 
reply to it with the reply ( r ) command, forward it with the forward ( f ) 
command, or skip to the next message by pressing RETURN. Deletion 
causes the mail program to forget about the message. This is not irreversi- 
ble; the message can be undeleted with the undelete (u) command by 
entering: 

u number 


3.4.5 Composing mail 

To compose mail, you must enter compose mode. Do this from XENIX 
command level by entering: 

mail john 

where john is the name of a user to whom you want to send mail. From 
mail command mode, you can enter compose mode with the mail, reply, 
or Reply commands. Once in compose mode, the text that you enter is 
appended one line at a time to the body of the message you are sending. 
Normal line editing functions are available when entering text, including 
Ctrl-u to kill a line and Backspace to back up one character. Note that 
when you enter two interrupts in a row (i.e., pressing INTERRUPT twice), 
your composition is aborted. 

While you are composing a message, mail treats lines beginning with the 
tilde character (~) in a special way. This character introduces commands 
called compose escapes. For example, entering: 
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m 

by itself on a line places a copy of the most recently printed message inside 
the message you are composing. The copy is shifted right one tab stop. 

Other escapes set up heading fields, add and delete recipients to the mes- 
sage, allow you to escape to an editor, let you revise the message body, or 
run XENIX commands. To get a list of the available compose escapes when 
in compose mode, enter: 

-? 

See also Section 3.6, “Leaving Compose Mode Temporarily,” later in this 
chapter. 


3.4.6 Forwarding mail 

To forward a message, use the forward (f)command. For example, enter: 
f john 

to place a copy of the current message inside a new message. The copy is 
shifted right one tabstop, and the new message is forwarded to John. John 
will receive a message heading indicating that you have forwarded the mes- 
sage. The Forward ( F ) command works just like its lowercase counter- 
part, except that the forwarded message is not shifted right one tabstop. 


3.4.7 Replying to mail 

You can use the reply command to set up a response to a message, 
automatically addressing a reply to the person who sent the original mes- 
sage. You can enter text and send the message by pressing Ctrl-d on a line 
by itself. The Reply command works just like its lowercase counterpart, 
except that the message is sent to others named in the original message’s 
To: and Cc: fields. 


3.4.8 Specifying Messages 

Commands such as print and delete can be given a message-list argument 
to apply to several messages at once. Thus “delete 2 3” deletes messages 2 
and 3, while “delete 1-5” deletes messages 1 through 5. A star (*) 
addresses all messages, and a dollar sign ($) addresses the last (highest 
numbered) message. The top ( t ) command displays the first five lines of a 
message; hence, you can enter: 

top * 
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to display the first five lines of every message. Message-lists can contain 
combinations of lists, ranges, and names. For example, the following com- 
mand displays all messages from tom or bob and numbered 2, 4, 10, 11, or 
12: 


p tom bob 2 4 10-12 


3.4.9 Creating Mailing Lists 

You can create personal mailing lists so that, for example, you can send 
mail to cohorts and have it go to a group of people. Such lists are defined by 
placing an alias line like: 

alias cohorts bill bob barry 

in the file . mailrc in your home directory. The current fist of such aliases 
can be displayed with the alias (a) mail command. Personal aliases are 
expanded in mail sent to others so that they will be able to Reply to each 
individual recipient. For example, the To: field in a message sent to 
cohorts will read: 

To: bill bob barry 

and not: 

To: cohorts 


Normally, system-wide aliases are available to all users. These are 
installed by whoever is in charge of your system. For more information, 
see section 3.8, “Using Advanced Features,” later in this chapter. 


3.4.10 Sending Network mail 

mail can be sent between XENIX machines connected with Micnet by 
specifying a machine name and the user name on that machine, separated 
by a colon: 

machine:user 

If appropriate gateways are known to your system, you can send mail to 
sites within the UUCP network using the syntax: 

machineluser 

(Be sure to escape the exclamation point (!) by preceding it with a 
backslash (\) when giving it on a csh command line.) mail may also 
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interpret other characters in the mail path when dealing with other net- 
works. In most cases, aliases should be set up so that specifying machine 
names is unnecessary. For more information about sending network mail, 
see the XENIX Operations Guide . For more information about UUCP, see 
the XENIX Reference Manual. 


3.4.11 Setting Options 

mail has several options that you can set from mail command mode or in 
the file .mailrc in your home directory. For example, “set askcc” enables 
the askcc switch and causes prompting for additions to the Cc: field when 
you finish composing a message. These and other options are discussed in 
Section 3.7 “Setting Up Your Environment: The .mailrc File.” 


3.5 Commands 

This section describes each of the commands available to you in mail com- 
mand mode. The examples in this section assume you have invoked mail 
and that you have several messages you want to dispose of. Note that in 
general, mail commands can be invoked with either the name of the com- 
mand or a one- or two-character mnemonic abbreviation. In the text of 
the command descriptions below, this mnemonic abbreviation is enclosed 
in parentheses after the name of the command. All commands are printed 
in boldface, except in the examples. 


3.5.1 Getting Help: help and? 

The help (?) command displays a brief summary of all mail commands, so 
if you ever get stuck when you are in mail command mode, enter: 

? 


or: 


help 


3.5.2 Reading mail: p, +, — , and restart 

To look at a specific message, use the print ( p ) command. For example, 
pretend you have a header-list that looks like this: 

3 john Wed Sep 21 09:21 26/782 “Notice” 

2 sam Tue Sep 2022:55 6/83 “Meeting” 

1 tom Mon Sep 1901:23 6/84 “Invite” 
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Reading from the left, each header contains the message number, who 
sent it, the day, date, and time it was sent, the number of lines and charac- 
ters in the message, and its subject. 

To examine the second message, enter: 

p2 

This might cause mail to respond with: 

Message 2: 

>From sam Tue June 2022:55 1985 
Subject: Meeting 

Meeting everyone, please do not forget! 


To look at message 3, enter: 


or to look at message 1, enter: 

+ 

The commands + and — execute relative to the last message referred to, 
which in our example was 2. For large numbers of messages, you can skip 
forward and backward by the number of messages specified as an argument 
to + and For example, entering: 

+3 

skips forward three messages. If you enter: 

P* 

then all messages are displayed, since the star (*) matches all messages. 

Pressing RETURN displays the next message in the header-list. You can 
always go to a message and print it by giving its message number or one of 
the special characters, caret f), dot (•)> or dollar sign ($). In the example 
where message 2 is the current message, to display the current message, 
enter: 
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To display message 1, enter: 


To display message 3, enter: 

$ 

When new mail arrives while you are in mail, the message “New mail has 
arrived-type ‘restart’ to read. ” If you wish to read the new messages, enter: 

restart 

The headers of the new messages appear. 


3.5.3 Finding Out the Number of the Current Message: = 

The number ( = ) command displays the message number of the current 
message. It takes no arguments. 

3.5.4 Displaying the First Five Lines : t 

The top ( t ) command takes a message-list and displays the first five lines 
of each addressed message. For example: 

top 2-12 


displays the first five lines of each of the messages 2 through 12. Note that 
the number of lines displayed by top can be set with the toplines option. 


3.5.5 Displaying Headers: h 

The headers ( h ) command displays header windows or lists of headers. A 
header window contains no more than 18 headers. With no argument, the 
headers command displays a header window in which the current message 
header is displayed at the center of the window. 

To examine the next set of 18 headers, enter: 

h + 

To examine the previous set, enter: 
h- 
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Both plus and minus take an optional numeric argument that indicates the 
number of header windows to move forward or backward before printing. 
If a message-list is given, then the headers command displays the header 
line for each message in the list, disregarding all windowing. For example: 

h joe 

displays all the message headers from joe. The following are some charac- 
teristics of the header-list: 

- Deleted messages do not appear in the listing. 

- Messages saved with the save command are flagged with a star (*). 

- Messages to be saved in your user mailbox are flagged with an “M”. 

- If the autombox option is set, messages held with the hold com- 
mand are flagged with an “H”. 


3.5.6 Deleting Messages: d and dp 

Unless you indicate otherwise, each message you receive is automatically 
saved in the system mailbox when you quit mail. Often, however, you do 
not want to save messages you have received. To delete messages, use the 
delete (d ) command. For example: 

delete 1 

prevents mail from retaining message 1 in the system mailbox. The mes- 
sage will disappear altogether, along with its number. 

The dp command deletes the current message and displays the next mes- 
sage. It is useful for quickly reading and disposing of mail. Using dp is the 
same as using the d command with the autoprint option set. See also the 
undelete command, below. 


3.5.7 Undeleting Messages: u 

The undelete ( u ) command causes a message that has been previously 
deleted with d or dp to reappear as if it had never been deleted. For exam- 
ple, to undelete message 3, enter: 

u3 

You cannot undelete messages from previous mail sessions; they are per- 
manently deleted. 
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3.5.8 Leaving mail : q and x 

When you have read all your messages, you can leave mail with the quit ( q ) 
command. All messages are held in your system mailbox, except the fol- 
lowing: 

- Deleted messages, which are discarded irretrievably. 

- Messages marked with the mbox command, which are saved in 
mbox in your home directory (that is, your user mailbox). 

- Messages saved with the save and write commands are deleted from 
the system mailbox. Forwarded messages are not deleted. 

Note that if the autombox option is set, messages that you have read are 
automatically saved in your user mailbox. If you wish to leave mail quickly 
without altering either your system or user mailbox, you can use the exit ( x 
) command. This returns you to the shell without changing anything: no 
messages are deleted or saved. Files that you invoke with the mail -f 
switch are unaffected as well. 


3.5.9 Saving Your mail: s 

The save ( s ) command lets you save messages to files other than mbox. By 
using save, you can organize your mail by putting messages in appropriate 
files. The save command writes out each message to the file given as the 
last argument on the command line. For example, the following command 
appends messages 1-5 to the file letters : 

s 1-5 letters 

The file letters is created if it does not already exist. Saved messages are not 
automatically retained in the system mailbox when you quit, nor are they 
selected by the print command described above, unless explicitly 
requested. Each saved message is marked with a star (*). 

Save writes out the entire message, including the To:, Subject:, and Cc: 
fields. In comparison, the write command, discussed below, writes out 
only the bodies of the specified messages. 


3.5.10 Saving Your mail: w 

The write ( w ) command writes out the body of each message to the file 
given as the last argument on the command line. Each written message is 
marked with a star (*). The syntax is similar to that of the save command. 
For example, 
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w3-17john elliotbook 

writes out the bodies of all messages from john and elliot in the number 
range 3-17. They are concatenated to the end of the file named book. 


3.5.11 Saving Your mail: mb 

The mbox ( mb ) command marks each message specified in a message- 
list, so that all are saved in the user mailbox when a quit command is exe- 
cuted. Message headers are marked with an “M” to show that they are to 
be saved in mbox . 


3.5.12 Saving Your mail: ho 

The hold ( ho ) command takes a message-list and marks each message so 
that it is saved in your system mailbox instead of deleted or saved in mbox 
when you quit. Saving of files in the system mailbox happens by default, so 
use hold only when you have also set the autombox option. 


3.5.13 Printing Your mail on the Lineprinter: 1 

The Ipr ( 1 ) command paginates and prints out messages to the lineprinter. 
It takes a message-list as its argument, then paginates and prints out each 
message. For example: 

ldoug 

prints out each message from the user doug on the lineprinter. 


3.5.14 Sending mail: m 

To send mail to a user, use the mail ( m ) command. This sends mail in the 
manner described for the reply command, except that you supply a list of 
recipients either as an argument or by entering them in the To: field. All 
compose escapes work in mail. Note that the mail command is in most 
ways identical to entering mail users at the XENIX command level. 


3.5.15 Replying to mail: rand R 

Often, you want to deal with a message by responding to its author right 
away. The reply ( r ) command is useful for this purpose: it takes a 
message-list and sends mail to the author of each message. The original 
message’s subject field is copied as the reply’s subject. Each message is 
created in compose mode; thus all compose escapes work in reply, and 
messages are terminated by pressing Ctrl-d. 
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The Reply ( R ) command works just like its lowercase counterpart, except 
that copies of the reply are also sent to everyone shown in the original 
message’s To: and Cc: fields. 


3.5.16 Forwarding mail: f and F 

To forward a copy of a message, use the forward ( f ) command. This 
causes a copy of the current message to be sent to the specified users. The 
message is marked as saved, and then deleted from the system mailbox 
when you exit mail. For example, to forward the current message to some- 
one whose login name is john, enter: 

f john 

John will receive the forwarded message, along with a heading showing 
that you are the one who forwarded it. The forwarded message is indented 
one tab stop inside the new message. An optional message number can 
also be given. For example: 

f 2 john bill 

forwards message 2 to john and bill. 

The Forward ( F ) command is identical to the lowercase forward com- 
mand, except that the forwarded message is not indented. 


3.5.17 Creating mailing Lists: a 

The alias ( a ) command links a group of names with the single name given 
by the first argument, thus creating a mailing list. For example, you could 
enter: 


alias beatles john paul george ringo 

so that whenever you used the name beatles in a destination address (as in 
“mail beatles”), it would be expanded so that you are really referring to the 
four names aliased to beatles. With no arguments, alias displays all 
currently-defined aliases. With one argument, it prints out the users 
defined by the given alias. 

You will probably want to define aliases in the startup file, .mailrc, so that 
you do not have to redefine them each time you invoke mail. See section 
6.7, “Setting Up Your Environment: The .mailrc File,” for more informa- 
tion. 
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3.5.18 Setting and Unsetting Options: se anduns 

mail switch and string options can be set with the mail commands set and 
unset. A switch option is either on or off (set or unset). String options are 
strings of characters that are assigned values with the syntax option^ string. 
Multiple options may be specified on a line. It is most useful to place set 
and unset commands in the file . mailrc in your home directory, where they 
become your own personal default options when you invoke mail. For 
example, you might have a set command that looked like this: 

set dot metoo toplines=10 SHELL=/usr/bin/sh 

The options dot and metoo are switch options; toplines and SHELL are 
string options. 

The command 

set ? 

displays a list of the available options. See the section “Setting Up Your 
Environment, ,, for descriptions of these options. 


3.5. 19 Editing a message: e and v 

Invoke the edit command to edit individual messages while using the text 
editor. The edit command takes a message list and processes each message 
in turn by writing it to a temporary file. The editor, ed } is then automatically 
invoked so that you can edit the temporary file. When you finish editing the 
message, write the message out, then quit the editor, mail reads the mes- 
sage b ack into the message buffer and removes the temporary file. 

It is often useful to be able to invoke either a line or visual editor, depend- 
ing on the type of terminal you are using. To invoke vi, you can use the 
visual ( v ) command. The operation of the visual command is otherwise 
identical to that of the edit command. 


3.5.20 Executing Shell Commands: shand ! 

To execute a shell command without leaving mail, precede the command 
with an exclamation point. For example: 

!date 

displays the current date without leaving mail. To enter a new shell, enter: 
sh 
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To exit from this new shell and return to mail command mode, press Ctrl- 
d. 


3.5.21 Finding Out the Number of Characters in a Message: si 

The size ( si ) command displays the number of characters in each message 
in a message-list. For example, the command: “si 1-4” might display: 

4: 234 
3: 1000 
2: 23 
1: 456 


3.5.22 Changing the Working Directory: cd 

The cd command changes the working directory to the name of the direc- 
tory you give it as an argument. If no argument is given, the directory is 
changed to your home directory. This command works just like the nor- 
mal XENIX cd command. (Note that exiting mail returns you to the direc- 
tory from which you entered mail; thus the mail cd command works only 
within mail.) You may want to place a cd command in your .mailrc file so 
that you always begin executing mail from within the same directory. 


3.5.23 Reading Commands From a File: so 

The source ( so ) command reads in mail commands from named file. 
Normally, these commands are alias, set, and unset commands. 


3.6 Leaving Compose Mode Temporarily 

While composing a message to be sent to others, it is often useful to print a 
message, invoke the text editor on a partial message, execute a shell com- 
mand, or perform some other function, mail provides these capabilities 
through compose escapes (sometimes called tilde escapes ) which consist of 
a tilde (~) at the beginning of a line, followed by a single character that 
specifies the function to be performed. These escapes are available only 
when you are composing a new message. They have no meaning when you 
are in mail command mode. The available compose escapes are described 
below. 
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3.6.1 Getting Help: ~? 

The help escape is the first compose escape you should know because it 
tells you about all the others. For example, if you enter: 

~? 

a brief summary of the available compose escapes is displayed on your 
screen. Note that~h prompts for heading fields and and does not give help. 


3.6.2 Printing the Message: ~p 

To print the current text of a message you are composing, enter: 

~P 

This prints a line of dashes and the heading and body of the message so far. 


3.6.3 Editing the Message: ~e and ~v 

If you are dissatisfied with a message as it stands, you can edit the message 
by invoking the editor, ed, with the editor escape, ~e. This causes the mes- 
sage to be copied into a temporary file so that you can edit it. Similarly, the 
~v escape causes the message to be copied into a temporary file so that you 
can edit it with the vi editor. After modifying the message to your satisfac- 
tion, write it out and quit the editor, mail responds by entering: 

(continue) 

after which you may continue composing your message. 


3.6.4 Editing Headers: ~t, ~c, ~b, ~s, ~R and ~h 

To add additional names to the list of message recipients, enter the escape: 
~t namel name2 ... 

You can name as many additional recipients as you wish. Note that users 
originally on the recipient list will still receive the message: you cannot 
remove anyone from the recipient list with ~t. To remove a recipient, use 
the ~h command, which is discussed later in this section. 

You can replace or add a subject field by using the ~s escape: 

~s line- of- text 
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This replaces any previous subject with line- of- text . The subject, if given, 
appears near the top of the message, prefixed with the heading Subject:. 
You can see what the message looks like by using ~p, which displays all 
heading fields along with the body of the text. 

You may occasionally prefer to list certain people as recipients of carbon 
copies of a message rather than direct recipients. The escape: 

~c namel name2 ... 

adds the named people to the Cc: list. The escape: 

~cc namel name2 ... 

performs an identical function. Similarly, the escape: 

~b namel name2 ... 

adds the named people to the Bcc: (Blind carbon copy) list. The people on 
this list receive a copy of the message, but are not mentioned anywhere in 
the message you send. Remember that you can always execute a ~p escape 
to see what the message looks like. 

The escape: 

~R 

adds or changes the person or persons named in the return- receipt- to: 
field. 

The recipients of the message are given in the To: field; the subject is given 
in the Subject: field, carbon copy recipients are given in the Cc: field and 
the return receipt recipient in the Return- receipt- to: field. If you wish to 
edit these in ways impossible with the ~t, ~s, ~c, and ~R escapes, you can 
use: 


~h 

where h stands for “heading.” The escape ~h displays To: followed by the 
current list of recipients and leaves the cursor at the end of the line. If you 
enter ordinary characters, they are appended to the end of the current list 
of recipients. You can also use the normal XENIX command line editing 
characters to edit these fields, so you can erase existing heading text by 
b ackspacing over it. 

When you press RETURN, mail advances to the Subject: field, where the 
same rules apply. Another RETURN brings you to the Cc: field, another 
brings you to the Bcc: field, and yet another to the Return- receipt- to: field. 
Each of these fields can be edited in the same way. Finally, another 
RETURN leaves you appending text to the end of your message body. As 
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always, you can use ~p to print the current text of the heading fields along 
with the body of the message. 


3.6.5 Adding a File to the Message: ~r and~d 

It is often useful to be able to include the contents of some file in your mes- 
sage. The escape: 

~r filename 

is provided for this purpose, and causes the named file to be appended to 
your current message, mail complains if the file does not exist or cannot be 
read. If the read is successful, mail displays the number of lines and charac- 
ters appended to your message. 

Asa special case of ~r, the escape: 

~d 

reads in the file dead, letter in your home directory. This is often useful 
because mail copies the text of your message buffer to dead, letter whenever 
you abort the creation of a message. You can abort the message by entering 
two consecutive interrupts or by entering a ~q escape. 


3.6.6 Enclosing Another Message: ~m and ~M 

If you are sending mail from within mail’s command mode, you can insert a 
message, that was previously sent to you, into the message that you are 
currently composing. For example, you might enter: 

~m 4 

This reads message 4 into the message you are composing, shifted right one 
tab stop. The escape: 

~M 4 

performs the same function, but with no right shift. You can name any 
nondeleted message or list of messages. 


3.6.7 Saving the Message in a File: 

To save the current text of a message body in a file, use: 
~w filename 
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mail writes out the message body to the specified file, then displays the 
number of lines and characters written to the file. The ~w escape does not 
write the message heading to the file. 


3.6.8 Leaving mail Temporarily: ~! and~| 

To temporarily escape to the shell, use the escape: 

~! command 

This executes command and returns you to mail compose mode without 
altering your message. If you wish to filter the body of your message 
through a shell command, use: 

~| command 

This pipes your message through the command and uses the output as the 
new text of your message. If the command produces no output, mail 
assumes that something is wrong. It retains the old version of your mes- 
sage, and displays: 

(continue) 


3.6.9 Escaping to mail Command Mode: 

To temporarily escape to mail command mode, use either of the escapes: 
~\mail - command 


~_rnail- command 

You can then execute any mail command that you want. Note that this 
escape will not work in most cases if you enter compose mode from the 
XENIX shell. It depends on the command used (set and unset will work), 
but most commands that involve message lists are not allowed. You will 
receive the message: 

May not execute cmd while composing 
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3.6. 10 Placing a Tilde at the Beginning of a Line: ~~ 

If you wish to send a message that contains a line beginning with a tilde, you 
must enter it twice. For example, entering: 

“'"'This line begins with a tilde. 

appends: 

"'This line begins with a tilde. 

to your message. The escape character can be changed to a different char- 
acter with the escape option. (For information on how to set options, see 
section 6.7, “Setting Up Your Environment: The .mailrc File.”) If the 
escape character is not a tilde, then this discussion applies to that character 
and not the tilde. 


3.7 SettingUp Your Environment: The .mailrc File 

Whenever mail is invoked, it first reads the file / usr / lib / mail / mailrc then 
the file .mailrc in the user’s home directory. System-wide aliases are 
defined in / usr / lib / mail I mailrc. Personal aliases and set options are 
defined in .mailrc. The folio wing is a sample, ma ilrc file: 

# number sign introduces comments 

# personal aliases office and cohorts are defined below 

alias office bill steve karen 

alias cohorts john marybob beth mike 

# set dot lets messages be terminated by period on new line 

# set askcc says to prompt for Cc : list after composing message 
set dot askcc 

# cd changes directory to different current directory 
cd 


3.7.1 The Subject Prompt: asksubject 

The asksubject switch causes prompting for the subject of each message 
before you enter compose mode. If you respond to the prompt with a 
RETURN, then no subject field is sent. 
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3.7.2 The CC Prompt: askcc 

The askcc switch causes prompting for additional carbon copy recipients 
when you finish composing a message. Responding with a RETURN sig- 
nals your satisfaction with the current list. Pressing INTERRUPT displays: 

interrupt 

(continue) 

so that you can return to editing your message. 


3.7.3 Printing the Next Message: autoprint 

The autoprint switch causes the delete command to behave like dp. After 
deleting a message, the next message in the list is automatically printed. 
Printing also occurs automatically after execution of an undelete com- 
mand. 


3.7.4 Listing Messages in Chronological Order: chron and mchron 

The chron switch causes messages to be listed in chronological order. By 
default, messages are listed with the most recent first. Set chron when you 
want to read a series of messages in the order they were received . 

The mchron switch, like chron, displays messages in chronological order, 
but lists them in the opposite order, that is, highest-numbered, or most 
recent, first. This is useful if you keep a large number of messages in your 
mailbox and you wish to list the headers of the most recently received mail 
first but read the messages themselves in chronological order. 


3.7.5 Using the Period to Send a Message: dot 

The dot switch lets you use a period (.) as an end-of-transmission charac- 
ter, as well as Ctrl-d. This option is available for those who are used to this 
convention when editing with the editor, ed. 


3.7.6 Sending mail While in mail: execmail 

It is often desirable to reply to a piece of mail, or send mail while reading 
your mail file. This process is speeded up by the use of the execmail option. 
It causes the underbar prompt to return before mail is finished being sent. 
This frees the user to continue while mail performs mailing functions in the 
background. 
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3.7.7 IncludingYourselfinaGroup:metoo 

Usually, when a group is expanded that contains the name of the sender, 
the sender is removed from the expansion. Setting the metoo option 
causes the sender to be included in the group. 


3.7.8 Saving Aborted Messages: save 

The nosave switch prevents aborted messages from being appended to the 
file dead. letter in your home directory; messages are saved by default. You 
can abort messages when you are in compose mode by entering two inter- 
rupts or a ~q compose escape. 


3.7.9 Printing the Version Header: quiet 

The quiet switch suppresses the printing of “<n> messages:” before the 
header-list, and suppresses printing of the version header when mail is first 
invoked. 


3.7.10 Choosing an Editor: The EDITOR String 

The EDITOR string contains the pathname of the text editor to use in the 
edit command and ~e escape. If not defined, then the default editor is used. 
For example: 

set EDITOR=/bin/ed 


3.7.11 Choosing an Editor: The VISUAL String 

The VISUAL string contains the pathname of the text editor used in the 
visual command and ~v escape. For example: 

set VISUAL=/bin/vi 

By default, vi is the editor used . 


3.7.12 Choosing a Shell: The SHELL String 

The SHELL string contains the name of the shell to use in the ! command 
and the ~! escape. A default shell is used if this option is not defined. For 
example: 

set SHELL=/bin/ sh 
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3.7.13 Changing the Escape Character: The escape String 

The escape string defines the character to use in place of the tilde (~) to 
denote compose escapes. For example: 

set escape=* 

With this setting, the asterisk becomes the new compose escape character. 


3.7.14 Setting Page Size: The page String 

The page string causes messages to be displayed in pages of size n lines. 
You are prompted with a question mark between pages. Pressing RETURN 
causes the next page of the current message to be displayed. By default this 
paging feature is turned off . 


3.7. 15 Saving Outgoing mail: The record String 

The record string sets the pathname of the file used to record all outgoing 
mail. If not defined, then outgoing mail is not copied and saved. For exam- 
ple: 


set record=/usr/john/recordfile 

With this setting, all outgoing mail is automatically appended to the file 
/ usr / john / record file. 


3.7.16 Keeping mail in the System mailbox: autombox 

The autombox switch determines whether messages remain in the system 
mailbox when you exit mail. If you set autombox, the examined messages 
are automatically placed in the mbox file in your home directory (your user 
mailbox). They are removed from the system mailbox when you quit. 


3.7.17 Changing the top Value: The toplines String 

The toplines string sets the number of lines of a message to be displayed 
with the top command. By default, this value is five. For example: 

set toplines=10 

With this setting, ten lines of each message are displayed when the top 
command is used. 


3-30 



mail 


3.7. 18 Sending mail Over Telephone Lines: ignore 

The ignore switch causes interrupt signals from your terminal to be ignored 
and echoed as at-signs (@). This switch is normally used only when com- 
municating with mail over telephone lines. 

3.8 Using Advanced Features 

This section discusses advanced features of mail useful to those with some 
existing familiarity with the XENIX mail system. 


3.8.1 Command Line Options 

One very useful command line option to mail is the — s “subject” switch. 
You can specify a subject on the command line with this switch. For exam- 
ple, you could send a file named letter with the subject line, “Important 
Meeting at 12:00”, by entering the following: 

mail -s “Important Meeting at 12:00” john bob mike cletter 


To include other header fields in your message, you can use the following 
options: 

-b user Adds the blind carbon copy field to the message header. 

-c user Adds the carbon copy field to the message header. 

-r user Adds the return -receipt to : field to the message header . 

None of the above options maybe specified more than once on a mail com- 
mand line. If multiple arguments are required for an option, the entire 
argument set must be enclosed in quotes, as in: 

mail -r “meeting” -b singleuser -c “x y z” user user2 


mail also allows you to edit files of messages by using the -f switch on the 
command line. For example: 

mail -f filename 

causes mail to edit filename and the command: 
mail -f 

causes mail to read mbox in your home directory. All the mail commands 
except hold are available to edit the messages. When you enter the quit 
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command, mail writes the updated file back. 

If you send mail over a noisy phone line, you may notice that bad charac- 
ters are transmitted. These are characters that abort messages: RUBOUT 
and DEL. You can invoke mail with the -i switch to ignore these bad char- 
acters. 

When you enter the mail program (as opposed to sending a message from 
command level), two command line options are available: 

-R Makes the mail session read-only, preventing alteration of the 
mailbeingread. 

-u user Reads in user’s mail instead of your own. 


3.8.2 Using mail as a Reminder Service 

Besides sending and receiving mail, you can use mail as a reminder service. 
Several XENIX commands have this idea built in to them. For example, 
the XENIX lp command’s -m switch causes mail to be sent to the user 
after files have been printed on the lineprinter. XENIX automatically 
examines the file named calendar in each user’s home directory and looks 
for lines containing either today or tomorrow’s date. These lines are sent 
by mail as a reminder of important events. 

If you program in the shell command language, you can use mail to signal 
the completion of a job. For example, you might place the following two 
lines in a shell procedure: 

biglongjob 

echo “biglongjob done” |mail self 


You can also create a a logfile that you want to mail to yourself. For exam- 
ple, you might have a shell procedure that looks like this: 

dosomething > logfile 
mail self < logfile 

For information about writing shell procedures, see Chapter 4 of this 
manual, “The Shell.” 


3.8.3 Handling Large Amounts of mail 

Eventually, you will face the problem of dealing with an accumulation of 
messages in your user mailbox. There are a number of strategies that you 
can employ to solve this problem concerning space in your* mailbox file. 
Keep in mind the dictum: 
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When in doubt, throw it out. 

This means that you should only save important mail in your user mailbox. 
If your mailbox file becomes large, you must periodically examine its con- 
tents to decide whether messages are still relevant. To save space, consider 
summarizing very long messages. 

The previously mentioned measures are not always helpful enough in 
organizing the many messages that you are likely to receive. Another 
effective approach is to save mail in files organized by sender, by topic, or 
by a combination of the two. Create these files in a separate mail directory; 
you can access these mailbox files with the mail -f filename switch. How- 
ever, be forewamed-this approach to organizing mail quickly eats up disk 
space. 


3.8.4 Maintenance and Administration 

The following is a list of the programs and files that make up the XENIX 
mail system: 


/usr/bin/mail 

mail program 

/ usr/lib / m ail/ mailrc 

mail system initialization file 

/ usr/ spool/mail/* 

System mailbox files 

/usr/ name/ dead . letter 

File where undeliverable mail is 
deposited 

/usr/ name /mb ox 

User mailbox 

/usr/ name! .mailrc 

User mail initialization file 

/ usr/lib / m ail/ m ailhelp . cmd 

mail command help file 

/usr/lib /m ail/ m ailhelp . esc 

mail compose escape help file 

/ usr/lib / m ail/ m ailhelp . set 

mail option help file 

/ usr/lib / m ail/ aliases 

System -wide aliases 

/usr/lib /mail/aliases. hash 

System-wide alias database 

/ usr/lib / m ail/f aliases 

Forwarding aliases 

/ usr/lib / m ail/m aliases 

Machine aliases 

/usr/lib /mail/maliases. hash 

Optional machine aliases database 
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A system-wide distribution list is kept in / usr/ lib / mail /aliases. A system 
administrator is usually in charge of this list. These aliases are kept in a 
vastly different syntax from .mailrc, and are expanded when mail is sent. 
You will normally need special permission to change system-wide aliases. 


3.9 Quick Reference 

The following sections provide quick reference to the available com- 
mands, compose escapes, and options. 


3.9.1 Command Summary 


Given below are the name and syntax for each command, the abbreviated 
form (in brackets), and a short description. Many commands have 
optional arguments; most can be executed without any arguments at all. In 
particular, commands that take a message-list argument will default to the 
current message if no message-list is given. In the following descriptions, 
ooiuiace denotes the name of a command, compose escape or option. 
Italics are used for arguments to commands or compose escapes. The vert- 
ical bar indicates selection and is used to separate the arguments from 
which you may select. All other text should be read literally. 

Displays the next message. 

[ + ] With no n argument, it displays the next 
message. If given a numeric argument n, goes to 
the nth message and displays it. 

[ — ] With no n argument, goes to the previous 
message and displays it. If given a numeric argu- 
ment n, goes to the nth previous message and 
displays it. 

Displays the first message. 

Displays the last message. 


RETURN 

+ /Z 

-A* 


Displays the message number of the current 
message. 

? Displays the summary of mail commands in 

/ usr /lib/ mail/ mailhelp. cmd. 

Ishell-cmd Executes the shell command that follows. No 

space is needed after the exclamation point. 

Alias users Displays system-wide aliases for users. At least 

one user must be specified. 
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alias name users [a] Aliases users to name. With no name argu- 
ments, displays all currently defined aliases. 
With one argument, displays the users aliased by 
the given name argument. 

cd directory [c] Changes the user’s working directory to the 

specified directory. If no directory is given, then 
changes to the user’s home directory. 

delete mesg-list [d] Deletes each message in the given message- 

list. 

dp mesg-list Deletes the current message and displays the 

next message. 

echo path Expands shell metacharacters. 

edit mesg- list [e] Takes the given message-list and points the 

text editor at each message in turn. On return to 
command mode, the edited message is read 
back in. See also the visual command. 

exit[!] [x] Immediately returns to the shell without 

modifying the system mailbox, the user mail- 
box, or a file specified with the — f switch. 

file [fi] Displays the name of the mailbox file. 

forward mesg- num user- list 

[f] Takes a user- list argument and forwards the 
current message to each name. The message 
sent to each is indented and shows that the 
sender has passed it on. The mesg- num argu- 
ment is optional, and is used to forward the 
numbered message instead of the default mes- 
sage. 

Forward mesg- num user- list 

[F] Same as forward except that the message is 
not indented. 

headers +/i \-n | mesg-list 

[h] With no argument, lists the current range of 
headers, which is an 18-message group. If a plus 
(+) argument is given, then the next 18-message 
group is displayed, and if a minus (-) argument 
is given, the previous 18-message group is 
displayed. Both plus and minus accept an 
optional numeric argument indicating the 
number of header-windows to move forward or 
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help 

hold mesg-list 

list 

Ipr mesg-list 

mail [user- list] 

mbox mesg-list 

move mesg- list mesg- 

print mesg- list 

quit 

reply mesg-list 
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backward. If a message-list is given, then the 
message-header for each message in the list is 
displayed. 

Same as ? above. Prints the summary of mail 
commands in /usr! lib! mail/ mailhelp. cmd. 

[ho] Takes a message-list and marks each mes- 
sage to be saved in the user’s system mailbox 
instead of in mbox. 

Prints list of mail commands. 

[l] Prints each of the messages in the required 
message-list on the lineprinter. Messages are 
piped through pr before being printed. 

[m] Takes an optional user-list argument and 
sends mail to each name after entering compose 
mode. 

[mb] Marks messages given in the message-list 
argument to be saved in the user mailbox when a 
quit is executed. Message headers contain an 
initial letter “M” to show that they are to be 
saved. 

num 

Places the messages specified in mesg-list after 
the message specified in mesg- num. If mesg- 
num is 0, mesg- list moves to the top of the mail- 
box. 

[p ] T akes a message-list and displays each mes- 
sage on the user’s terminal. 

[q] Terminates the mail session, retaining all 
nondeleted, unsaved messages in the system 
mailbox. If the autombox option is set, then 
examined messages are saved in the user mail- 
box, deleted messages are discarded, and all 
messages marked with the hold command are 
retained in the system mailbox. 

If you are executing a quit while editing a mail- 
box file with the — f flag, the mailbox file is 
rewritten and the user returns to the shell. 

[r] Takes a message-list and sends mail to each 
message author just like the mail command . 
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Reply mesg- list [R ] Sends a reply to users named in the To: and 

Cc: fields, as well as the original sender. 

restart Reads in mail that arrives during the current 

mail session. 

save mesg- list filename 

[s] Takes an optional message-list and a 
filename and appends each message in turn to 
the end of the file. The default message is the 
current message. 

set [se] Displays a list of available options. 

set option-list [se] With no arguments, displays all variable 

values. Otherwise, sets option. Arguments are 
of the form option^ value, if the option is a 
string option or just option , if the option is a 
switch. Multiple options maybe set on one line. 

shell [sh] Invokes an interactive version of the shell. 

size mesg- list [si] Takes a message-list and displays the size in 

characters of each message. 

source file [so] Reads and executes mail commands from 

the named file. 

s tring string mesg- list 

Searches for string in mesg- list. If no mesg- list is 
specified, all undeleted messages are searched. 
Ignores case in search. 

top [t] T akes a message-list and displays the top five 

lines. The number of lines displayed is set by the 
variable toplines. 

undelete mesg- list [u ] T akes a message-list and marks each one as 

not being deleted. Each message in the list must 
previously have been deleted. 

unset options [uns ] Takes a list of option names and discards 

their remembered values; this is the opposite of 

set. 

visual mesg- list [v] Takes a message-list and invokes the vi edi- 

tor on each one. 

whois Looks up a list of target mail recipients and 

prints the real names or descriptions of each 
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recipient. If the first character of the first argu- 
ment is alphabetic, the arguments are looked up 
without change. Otherwise, the arguments are 
assumed to be a message list, in the format 
specified in the mail User's Guide. For each 
message in the list, the “From” person is 
extracted from the header and added to list of 
users to be searched. 

write mesg- list filename 

[w] Writes the message bodies of messages given 
by the message-list to the file given by filename. 


3.9.2 Compose Escape Summary 

Compose escapes are used when composing messages to perform special 
functions. They are only recognized at the beginning of lines. The escape 
character can be set with the escape string option. (See section 6.7.14, “The 
escape String.”) Abbreviations for each escape are in brackets. 

Here is a summary of the compose escapes: 


~~string 

Inserts the string of text in the message prefaced by a 
single tilde Q. 

~? 

Prints out help for compose escapes on terminal. 


SameasCtrl-don a new line. 

~lcommand 

Executes a shell command, then returns to compose 
mode. 

~ | command 

Pipes the message body through the command as a 
filter. Replaces the message body with the output of 
the filter. If the command gives no output or ter- 
minates abnormally, retains the original message 
body. 


■ -mail- command Executes a mail command, then returns to compose 
mode. 


.mail- command Executes a mail command, then returns to compose 
mode. 

alia s [~a ] Displays a list of private aliases. 

alias aliasname [a] Displays the names included in private 
aliasname. 
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“alias aliasname users 

["a ] A dds users to private aliasname list. 

“■Alias ["A] Performs aliasing by first examining private 

aliases and then system -wide aliases using all three 
global alias files. Only the final result is printed 
(non-local mail recipients will have the complete 
delivery path printed). The user list is taken from 
header fields. 


'Alias users 


"bcc name ... 
~cc name ... 
"dead 

"editor 

"headers 


["A] Performs aliasing by first examining private 
aliases and then system-wide aliases using all three 
global alias files. Only the final result is printed 
(non-local mail recipients will have the complete 
delivery path printed). At least one user must be 
specified. 

["b] Adds the given names to the Bcc: field. 

["c] Adds the given name to the cc: field. 

[~d] Reads the file dead, letter from your home direc- 
tory into the message. 

["e] Invokes the line editor on the message being 
sent. Exiting the editor returns the user to compose 
mode. 

["h] Edits the message heading fields by printing 
each one in turn and allowing the user to modify each 
field. 


'message mesg- list 

["m] Reads the named messages into the message 
being sent, shifted right one tab. If no messages are 
specified, reads the current message. 


"Message mesg- list 

["M] Same as "message except with no right shift. 

"print ["p ] Prints the message buffer prefaced by the mes- 

sage heading. 

"Print ["P] Prints the real names or descriptions (in 

parentheses) after each recipient. 

"quit ["q ] Aborts the message being sent, copying the mes- 

sage to dead. letter in your home directory if the save 
option is set. 
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~rea& filename 
''Return name 

''shell 

"subject string 

~to name ... 
"visual 

"'write filename 


[~r] Reads the named file into the message. 

[~R] Adds the given names to the Return- receipt- to: 
field. 

["'sh] Invokes a shell. 

[~s] Causes the named string to become the current 
subject field. 

[’t] Adds the given names to the To: field. 

[-v] Invokes the vi editor to edit the message buffer. 
Exiting the editor returns the user to compose mode. 

[~w] Writes the message body to the named file. 


3.9.3 Option Summary 

Options are controlled with the set and unset commands. An option is 
either a switch or a string. A switch is either on or off, while a string option 
has a value that is a pathname, a number, or a single character. Options are 
summarized below. 


askcc Causes prompting for additional carbon copy recipients 

at the end of each message. Pressing RETURN retains 
the current list. 

asksubject Causes prompting for the subject of each message you 
send. The subject is a line of text terminated by a 
RETURN. 


autombox Usually messages are retained in the system mailbox 
when the user quits. However, if this option is set, 
examined messages are automatically appended to the 
user mailbox. 


autoprint Causes the delete command to behave like dp. Thus, 
after deleting (or undeleting) a message, the next one is 
printed automatically. 


chron Causes messages to be listed in chronological order. 

dot Causes a single period on a newline to act as the EOT 

character. The normal end-of-transmission character, 
Ctrl-d, still works. 
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EDITOR = 

escap e=char 

ignore 

mchron 

metoo 

nosave 

page=AZ 
quiet 
record = 

SHELL= 

toplines = 
verify 

VISUAL= 


Pathname of the text editor to use in the edit command 
and ~e escape. If not defined, then a default editor is 
used. 

If defined, sets char as the character to use in place of 
the tilde (~) to denote compose escapes. 

Causes interrupt signals from your terminal to be 
ignored and echoed as at-signs (@). 

Causes messages to be listed in numerical order (most 
recently received first), but displayed in chronological 
order. 

Normally, before sending, the name of the sender is 
removed from alias expansions. If metoo is set, then the 
name of the sender is not removed . 

Prevents saving of the message buffer in the file 
dead, letter in the home directory, after two consecutive 
interrupts or a ~q escape. 

Specifies the number of lines (n) to be printed in a 
“page” of text when displaying messages. 

Suppresses the printing of the version when mail is first 
invoked. 

Sets the pathname of the file used to record all outgoing 
mail. Knot defined, then outgoing mail is not copied. 

Pathname of the shell to use in the ! command and the ~! 
escape. A default shell is used if this option is not 
defined. 

Sets the number of lines of a message to be printed with 
the top command. Default is five lines. 

Causes each target mail recipient to be verified. This 
option permits errors made while composing messages 
to be corrected or ignored. 

Pathname of the text editor to use in the visual com- 
mand and ~v escape. The default is for the vi editor. 
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4.1 Introduction 

When users log into XENIX, they communicate with one of serveral inter- 
preters. This chapter discusses the shell command interpreter, sh. This 
interpreter is a XENIX program that supports a very powerful command 
language. Each invocation of this interpreter is called a shell; and each 
shell has one function: to read and execute commands from its standard 
input. 

Because the shell gives the user a high-level language in which to communi- 
cate with the operating system, XENIX can perform tasks unheard of in 
less sophisticated operating systems. Commands that would normally 
have to be written in a traditional programming language can be written 
with just a few lines in a shell procedure. In other operating systems, com- 
mands are executed in strict sequence. With XENIX and the shell, com- 
mands can be: 

• Combined to form new commands 

• Passed positional parameters 

• Added or renamed by the user 

• Executed within loops or executed conditionally 

• Created for local execution without fear of name conflict with other 
user commands 

• Executed in the background without interrupting a session at a ter- 
minal 

Furthermore, commands can “redirect” command input from one source 
to another and redirect command output to a file, terminal, printer, or to 
another command. This provides flexibility in tailoring a task for a particu- 
lar purpose. 

4.2 basic Concepts 

The shell itself (that is, the program that reads your commands when you 
log in or that is invoked with the sh command) is a program written in the C 
language; it is not part of the operating system proper, but an ordinary user 
program. 
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4.2.1 How Shells Are Created 

In XENIX, a process is an executing entity complete with instructions, 
data, input, and output. All processes have lives of their own, and may 
even start (or “fork”) new processes. Thus, at any given moment several 
processes may be executing, some of which are “children” of other 
processes. 

Users log into the operating system and are assigned a “shell” from which 
they execute. This shell is a personal copy of the shell command interpreter 
that is reading commands from the keyboard: in this context, the shell is 
simply another process. 

In the XENIX multitasking environment, files may be created in one phase 
and then sent off to be processed in the “background.” This allows the user 
to continue working while programs are running. 


4.2.2 Commands 

The most common way of using the shell is by entering simple commands 
at your keyboard. A simple command is any sequence of arguments 
separated by spaces or tabs. The first argument (numbered zero) specifies 
the name of the command to be executed. Any remaining arguments, with 
a few exceptions, are passed as arguments to that command. For example, 
the following command line might be entered to request printing of the files 
allan, barry, and Calvin: 

lpr allan barry Calvin 


If the first argument of a command names a file that is executable (as indi- 
cated by an appropriate set of permission bits associated with that file) and 
is actually a compiled program, the shell, as parent, creates a child process 
that immediately executes that program. If the file is marked as being exe- 
cutable, but is not a compiled program, it is assumed to be a shell pro- 
cedure, that is, a file of ordinary text containing shell command lines. In 
this case, the shell spawns another instance of itself (a subshell) to read the 
file and execute the commands inside it. 

From the user’s viewpoint, compiled programs and shell procedures are 
invoked in exactly the same way. The shell determines which implementa- 
tion has been used, rather than requiring the user to do so. This provides 
uniformity of invocation. This provides uniformity of invocation. 
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4.2.3 How the Shell Finds Commands 

The shell normally searches for commands in three distinct locations in the 
file system. The shell attempts to use the command name as given; if this 
fails, it prepends the string /bin to the name. If the latter is unsuccessful, it 
prepends / usr/bin to the command name. The effect is to search, in order, 
the current directory, then the directory /bin, and finally, /usr/bin. For 
example, the pr and man commands are actually the files /bin/pr and 
/ usr/bin/man , respectively. A more complex pathname may be given, 
either to locate a file relative to the user’s current directory, or to access a 
command with an absolute pathname. If a given command name begins 
with a slash (/) (for example, /bin/ sort or /and), the prepending is not per- 
formed. Instead, a single attempt is made to execute the command as 
named. 

This mechanism gives the user a convenient way to execute public com- 
mands and commands in or near the current directory, as well as the ability 
to execute any accessible command, regardless of its location in the file 
structure. Because the current directory is usually searched first, anyone 
can possess a private version of a public command without affecting other 
users. Similarly, the creation of a new public command does not affect a 
user who already has a private command with the same name. The particu- 
lar sequence of directories searched may be changed by resetting the shell 
PATH variable. (Shell variables are discussed later in this chapter). 


4.2.4 Generation of Argument Lists 

The arguments to commands are very often filenames. Sometimes, these 
filenames have similar, but not identical, names. To take advantage of this 
similarity in names, the shell lets the user specify patterns that match the 
filenames in a directory. If a pattern is matched by one or more filenames 
in a directory, then those filenames are automatically generated by the shell 
as arguments to the command. 

Most characters in such a pattern match themselves, but there are also 
XENIX special characters that maybe included in a pattern. These special 
characters are: the star (*), which matches any string, including the null 
string; the question mark (?), which matches any one character; and any 
sequence of characters enclosed within brackets ([ and ]), which matches 
any one of the enclosed characters. Inside brackets, a pair of characters 
separated by a dash (-) matches any character within the range of that pair. 
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Thus [a-de] is equivalent to [abcde]. Examples of metacharacter usage: 

* Matches all names in the current directory 

*temp* Matches all n ames containing "temp" 

[a-f]* Matches all names beginning with V' through "/' 

*.c Matches all names ending in "c" 

/usr/bin/? Matches all single-character names in /usr/bin 

This pattern-matching capability saves typing and, more importantly, 
makes it possible to organize information in large collections of files that 
are named in a structured fashion, using common characters or extensions 
to identify related files. 

Pattern matching has some restrictions. If the first character of a filename 
is a period (.), it can be matched only by an argument that literally begins 
with a period. If a pattern does not match any filenames, then the pattern 
itself is printed out as the result of the match. 

Note that directory names should not contain any of the following charac- 
ters: 


*?n 

If these characters are used, then infinite recursion may occur during pat- 
tern matching attempts. 


4.2.5 Quoting Mechanisms 

The characters <,>,*,?,[ and ] have special meanings to the shell. To 
remove the special meaning of these characters requires some form of 
quoting. This is done by using single quotation marks Q or double quota- 
tion marks (") to surround a string. A backslash (\) before a single charac- 
ter provides this function . (Back quotation marks Q are used only for com- 
mand substitution in the shell and do not hide the special meanings of any 
characters.) 

All characters within single quotation marks are taken literally. Thus: 

echostuff='echo $?$*; Is *| wc' 
results in the string: 

echo $?$*;ls * | wc 

being assigned to the variable echostuff, but it does not result in any other 
commands b eing executed . 
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Within double quotation marks, the special meaning of certain characters 
does persist, while all other characters are taken literally. The characters 
that retain their special meaning are the dollar sign ($), the backslash (\), 
the single quotation mark ("), and the double quotation mark (") itself. 
Thus, within double quotation marks, variables are expanded and com- 
mand substitution takes place (both topics are discussed in later sections). 
However, any commands in a command substitution are unaffected by 
double quotation marks, so that characters such as star (*) retain their spe- 
cial meaning. 

To hide the special meaning of the dollar sign ($) and single and double 
quotation marks within double quotation marks, precede these characters 
with a b ackslash (\). Outside of double quotation marks, preceding a char- 
acter with a backslash is equivalent to placing single quotation marks 
around that character. A backslash (\) followed by a newline causes that 
newline to be ignored and is equivalent to a space. The back slash -newline 
pair is therefore useful in allowing continuation of long command lines. 

Some examples of quoting are displayed below: 


Input 


' i * 

The back quotation mark (') 

/ii/ 

The double quotation mark (") 

"'echo one'" 

the one word “'echo one'” 

M II 

The double quotation mark (") 

"'echo one'" 

the one word “one” 

• KM 

illeeal (expects another ') 

one two 

the two words “one” & “two” 

II A II 

one two 

the one word “one two” 

"one two" 

the one word “one two” 


the one word “one * two” 

i Li hi 1 1 m 

the one word “one * two” 

'echo one' 

the one word “one” 


In general, most commands do not know or care whether their input or 
output is coming from or going to a terminal or a file. Thus, a command 
can be used conveniently either at a terminal or in a pipeline. A few com- 
mands vary their actions depending on the nature of their input or output, 
either for efficiency, or to avoid useless actions (such as attempting ran- 
dom access I/O on a terminal or a pipe). 
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4.2.6 Standard Input and Output 

When a command begins execution, it usually expects that three files are 
already open: a “standard input”, a “standard output”, and a “diagnostic 
output” (also called “standard error”). A number called a file descriptor is 
associated with each of these files. By convention, file descriptor 0 is asso- 
ciated with the standard input, file descriptor 1 with the standard output, 
and file descriptor 2 with the diagnostic output. A child process normally 
inherits these files from its parent; all three files are initially connected to 
the terminal (0 to the keyboard, 1 and 2 to the terminal screen). The shell 
permits the files to be redirected elsewhere before control is passed to an 
invoked command. 

An argument to the shell of the form u <file ” or u >file ” opens the specified 
file as the standard input or output (in the case of output, destroying the 
previous contents of file , if any). An argument of the form “ »file ” 
directs the standard output to the end of file , thus providing a way to 
append data to the file without destroying its existing contents. In either of 
the two output cases, the shell creates file if it does not already exist. Thus: 

> output 

alone on a line creates a zero-length file. The following appends to file log 
the list of users who are currently logged on : 

who >> log 

Such redirection arguments are only subject to variable and command sub- 
stitution; neither blank interpretation nor pattern matching of filenames 
occurs after these substitutions. This means that: 

echo "this is a test" > *.gal 

produces a one-line file named *.gal. Similarly, an error message is pro- 
duced by the following command, unless you have a file with the name “?”: 

cat < ? 

So remember, special characters are not expanded in redirection argu- 
ments. The reason this is so is that redirection arguments are scanned by 
the shell before pattern recognition and expansion takes place. 


4.2.7 Diagnostic and Other Outputs 

Diagnostic output from XENIX commands is normally directed to the file 
associated with file descriptor 2. (There is often a need for an error output 
file that is different from standard output so that error messages do not get 
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lost down pipelines.) You can redirect this error output to a file by immedi- 
ately prepending the number of the file descriptor (2 in this case) to either 
output redirection symbol (> or >>). The following line appends error 
messages from the cc command to the file named ERRORS : 

cc testfile.c 2>> ERRORS 

Note that the file descriptor number must be prepended to the redirection 
symbol without any intervening spaces or tabs; otherwise, the number will 
be passed as an argument to the command. 

This method may be generalized to allow redirection of output associated 
with any of the first ten file descriptors (numbered 0-9). For instance, if 
cmd puts output on file descriptor 9, then the following line will direct that 
output to the file savedata : 

cmd 9> savedata 

A command often generates standard output and error output, and might 
even have some other output, perhaps a data file. In this case, one can 
redirect independently all the different outputs. Suppose, for example, 
that cmd directs its standard output to file descriptor 1, its error output to 
file descriptor 2, and builds a data file on file descriptor 9. The following 
would direct each of these three outputs to a different file: 

cmd > standard 2> error 9> data 


4.2.8 Command Lines and Pipelines 

A sequence of commands separated by the vertical bar ( |) makes up a 
pipeline. In a pipeline consisting of more than one command, each com- 
mand is run as a separate process connected to its neighbors by pipes, that 
is, the output of each command (except the last one) becomes the input of 
the next command in line. 

A filter is a command that reads its standard input, transforms it in some 
way, then writes it as its standard output. A pipeline normally consists of a 
series of filters. Although the processes in a pipeline are permitted to exe- 
cute in parallel, each program needs to read the output of its predecessor. 
Many commands operate on individual lines of text, reading a line, pro- 
cessing it, writing it out, and looping back for more input. Some must read 
large amounts of data before producing output; sort is an 
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example of the extreme case that requires all input to be read before any 
output is produced. The following is an example of a typical pipeline: 

nroff -mm text | col | lpr 

nroff is a text formatter available in the XENIX Text Processing System 
whose output may contain reverse line motions, col converts these 
motions to a form that can be printed on a terminal lacking reverse-motion 
capability, and lpr does the actual printing. The flag —mm indicates one of 
the commonly used formatting options, and text is the name of the file to be 
formatted. 

The following examples illustrate the variety of effects that can be obtained 
by combining a few commands in the ways described above. It may be 
helpful to try these at a terminal: 

• who 

Prints the list of logged-in users on the terminal screen. 

• who >> log 

Appends the list of logged -in users to the end of file log. 

• who | wc -1 

Prints the number of logged-in users. (The argument to wc is pro- 
nounced “minus ell”. ) 

• who | pr 

Prints a paginated list of logged-in users. 

• who | sort 

Prints an alphabetized list of logged -in users. 

• who | grep bob 

Prints the list of logged-in users whose login names contain the 
string bob. 

• who | grep bob | sort | pr 

Prints an alphabetized, paginated list of logged-in users whose login 
names contain the string bob. 

• { date; who | wc-1; } >> log 

Appends (to file log) the current date followed by the count of 
logged-in users. Be sure to place a space after the left brace and a 
semicolon before the right brace. 

• who |sed -e ' s/ .*/ /\0’ | sort | uniq -d 

Prints only the login names of all users who are logged in more than 
once. Note the use of sed as a filter to remove characters trailing the 
login name from each line. (The in the sed command is pre- 
ceded by a space.) 
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The who command does not by itself provide options to yield all these 
results-they are obtained by combining who with other commands. Note 
that who just serves as the data source in these examples. As an exercise, 
replace “who |” with “</etc/passwd” in the above examples to see how a 
file can be used as a data source in the same way. Notice that redirection 
arguments may appear anywhere on the command line, even at the start. 
This means that: 

< infile >outfile sort | pr 
is the same as: 

sort | pr < infile > outfile 


4.2.9 Command Substitution 

Any command line can be placed within back quotation marks ( . . . ) so 
that the output of the command replaces the quoted command line itself. 
This concept is known as command substitution. The command or com- 
mands enclosed between back quotation marks are first executed by the 
shell and then their output replaces the whole expression, back quotation 
marks and all. This feature is often used to assign to shell variables. (Shell 
variables are described in the next section.) 

For example: 

today='date' 


assigns the string representing the current date to the variable “today”; for 
example “Tue Nov 26 16:01:09 EST 1985”. The following command saves 
the number of logged-in users in the shell variable users : 

users= v who | wc -T 

Any command that writes to the standard output can be enclosed in back 
quotation marks. Back quotation marks may be nested, but the inside sets 
must be escaped with b ackslashes ( \ ). For example: 

logmsg= v echo Your login directory is YpwdY' 


will display the line “your login directory is name of login directory ”. Shell 
variables can also be given values indirectly by using the read and line com- 
mands. The read command takes a line from the standard input (usually 
your terminal) and assigns consecutive words on that line to any variables 
named. 
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For example: 

read first init last 
takes an input line of the form : 

G. A. Snyder 

and has the same effect as entering: 
first=G. init=A. last=Snyder 

The read command assigns any excess “words” to the last variable. 

The line command reads a line of input from the standard input and then 
echoes it to the standard output. 


4.3 Shell Variables 

The shell has several mechanisms for creating variables. A variable is a 
name representing a string value. Certain variables are referred to as posi- 
tional parameters ; these are the variables that are normally set only on the 
command line. Other shell variables are simply names to which the user or 
the shell itself may assign string values. 


4.3.1 Positional Parameters 

When a shell procedure is invoked, the shell implicitly creates positional 
parameters. The name of the shell procedure itself in position zero on the 
command line is assigned to the positional parameter $0. The first com- 
mand argument is called $1, and so on. The shift command may be used to 
access arguments in positions numbered higher than nine. For example, 
the following shell script might be used to cycle through command line 
switches and then process all succeeding files: 

while test '$T 

do case $1 in 

-a) A=aoption ; shift ;; 

-b) B=boption ; shift ;; 

-c) C=coption ; shift ;; 

-*) echo "bad option" ; exit 1 ;; 

*) process rest of files 
esac 

done 
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One can explicitly force values into these positional parameters by using 
the set command. For example: 

set abc def ghi 

assigns the string “abc” to the first positional parameter, $1, the string 
“def” to $2, and the string “ghi” to $3. Note that $0 may not be assigned a 
value in this way— it always refers to the name of the shell procedure, or in 
the login shell, to the name of the shell. 


4.3.2 User- Defined Variables 

The shell also recognizes alphanumeric variables to which string values 
maybe assigned. A simple assignment has the syntax: 

name=string 

Thereafter, %name will yield the value string. A name is a sequence of 
letters, digits, and underscores that begins with a letter or an underscore. 
No spaces surround the equal sign (=) in an assignment statement. Note 
that positional parameters may not appear on the left side of an assignment 
statement; they can only be set as described in the previous section. 

More than one assignment may appear in an assignment statement, but 
beware: the shell performs the assignments from right to left. Thus, the fol- 
lowing command line results in the variable “A” acquiring the value abc . 

A=$B B=abc 

The following arp examples of simple assignments. Double quotation 
marks around the right-hand side allow spaces, tabs, semicolons, and 
newlines to be included in a string, while also allowing variable substitution 
(also known as “parameter substitution”) to occur. This means that refer- 
ences to positional parameters and other variable names that are prefixed 
by a dollar sign ($) are replaced by the corresponding values, if any. Single 
quotation marks inhibit variable substitution: 

M A IL=/usr/ mail/ gas 
echovar="echo $1 $2 $3 $4" 
stars=***** 
asterisks= , $stars > 

In the above example, the variable “echovar” has as its value the string 
consisting of the values of the first four positional parameters, separated by 
spaces, plus the string “echo”. No quotation marks are needed around the 
string of asterisks being assigned to stars because pattern matching (expan- 
sion of star, the question mark, and brackets) does not apply in this con- 
text. Note that the value of Sasterisks is the literal string “$stars”, not the 
string “*****”, because the single quotation marks inhibit substitution. 
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In assignments, spaces are not re-interpreted after variable substitution, 
so that the following example results in $first and $ second having the same 
value: 


first='a string with embedded spaces' 
second=$first 


In accessing the values of variables, you may enclose the variable name in 
braces { . . . } to delimit the variable name from any following string. In par- 
ticular, if the character immediately following the name is a letter, digit, or 
underscore, then the braces are required. For example, examine the fol- 
lowing input: 


a="This is a string" 

echo "${a}ent test of variables." 

Here, the echo command prints: 

This is a stringent test of variables. 

If no braces were used, the shell would substitute a null value for “$aent” 
and print: 

test of variables. 


The following variables are maintained by the shell. Some of them are set 
by the shell, and all of them can be reset by the user: 

HOME Initialized by the login program to the name of the user’s 
login directory , that is, the directory that becomes the 
current directory upon completion of a login; cd without 
arguments switches to the $HOME directory. Using this 
variable helps keep full pathnames out of shell pro- 
cedures. This is of great benefit when pathnames are 
changed, either to balance disk loads or to reflect adminis- 
trative changes. 

IFS The variable that specifies which characters are internal 

field separators. These are the characters the shell uses 
during blank interpretation. (If you want to parse some 
delimiter-separated data easily, you can set IFS to include 
that delimiter.) The shell initially sets IFS to include the 
blank, tab, and newline characters. 

MAIL The pathname of a file where your mail is deposited. If 
MAIL is set, then the shell checks to see if anything has 
been added to the file it names and announces the arrival 
of new mail each time you return to command level (e.g.. 


4-12 



The Shell 


by leaving the editor). MAIL must be set by the user and 
“exported”. (The export command is discussed later in 
this chapter.) (The presence of mail in the standard mail, 
file is also announced at login, regardless of whether 
MAIL is set.) 

PATH The variable that specifies the search path used by the shell 
in finding commands. Its value is an ordered list of direc- 
tory pathnames separated by colons. The shell initializes 
PATH to the list :/bin:/usr/bin where a null argument 
appears in front of the first colon. A null anywhere in the 
path list represents the current directory. On some sys- 
tems, a search of the current directory is not the default 
and the PATH variable is initialized instead to 
/bin:lusr/bin. If you wish to search your current directory 
last, rather than first, use: 

PATH=/bin:/usr/bin: 

Below, the two colons together represent a colon followed 
by a null, followed by a colon, thus naming the current 
directory. You could possess a personal directory of com- 
mands (say, $HOME/bin) and cause it to be searched 
before the other three directories by using: 

PATH=$HOME/bin:/bin:/usr/bin 
“PATH” is normally set in your .profile file. 

CD PATH This variable defines the search path for the directory con- 
taining arg. Alternative directory names are separated by 
a colon (:). The default path is <null> (specifying the 
current directory). The current directory is specified by a 
null path name, which can appear immediately after the 
equal sign or between the colon delimiters anywhere else 
in the path list. If arg begins with a / then the search path is 
not used. Otherwise, each directory in the path is 
searched for arg. 

PS1 The variable that specifies what string is to be used as the 

primary prompt string. If the shell is interactive, it 
prompts with the value of PS1 when it expects input. The 
default value of PS1 is “$ ” (a dollar sign ($) followed by a 
blank). 

PS2 The variable that specifies the secondary prompt string. If 

the shell expects more input when it encounters a newline 
in its input, it prompts with the value of PS2. The default 
value for this variable is “> ” (a greater-than symbol fol- 
lowed by a space). 
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In general, you should be sure to export all of the above variables so that 
their values are passed to all shells created from your login. Use export at 
the end of your .profile file. An example of an export statement follows: 

export HOME IFS MAIL PATH PS1 PS 2 


4.3.3 Predefined Special Variables 

Several variables have special meanings; the following are set only by the 
shell: 

$# Records the number of arguments passed to the shell, not 

counting the name of the shell procedure itself. For 
instance, $# yields the number of the highest set positional 
parameter. Thus: 

sh cmd a b c 

automatically sets $# to 3. One of its primary uses is in 
checking for the presence of the required number of argu- 
ments: 

if test $# -It 2 
then 

echo 'two or more args required'; exit 
fi 

$? Contains the exit status of the last command executed (also 

referred to as “return code”, “exit code”, or “value”). Its 
value is a decimal string. Most XENIX commands return 
zero to indicate successful completion. The shell itself 
returns the current value of $? as its exit status. 

$$ The process number of the current process. Because pro- 

cess numbers are unique among all existing processes, this 
string is often used to generate unique names for temporary 
files. XENIX provides no mechanism for the automatic crea- 
tion and deletion of temporary files; a file exists until it is 
explicitly removed. Temporary files are generally undesir- 
able objects; the XENIX pipe mechanism is far superior for 
many applications. However, the need for uniquely-named 
temporary files does occasionally occur. 

The following example illustrates the recommended practice 
of creating temporary files; note that the directories / usr and 
/usr/tmp are cleared out if the system is rebooted. 
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# use current process id 

# to form unique temp file 
temp=/usr/ temp/$$ 

Is > $temp 

# commands here, some of which use $temp 
rm $temp 

# clean up at end 

$! The process number of the last process run in the back- 

ground (using the ampersand (&)). This is a string contain- 
ing from one to five digits. 

$- A string consisting of names of execution flags currently 

turned on in the shell. For example, $- might have the value 
“xv” if you are tracing your output. 


4.4 The Shell State 

The state of a given instance of the shell includes the values of positional 
parameters, user-defined variables, environment variables, modes of exe- 
cution , and the current working directory. 

The state of a shell may be altered in various ways. These include changing 
the working directory with the cd command, setting several flags, and by 
reading commands from the special file, .profile, in your login directory. 


4.4.1 Changing Directories 

The cd command changes the current directory to the one specified as its 
argument. This can and should be used to change to a convenient place in 
the directory structure. Note that cd is often placed within parentheses to 
cause a sub shell to change to a different directory and execute some com- 
mands without affecting the original shell. 

For example, the first sequence below copies the file /etc/passwd to 
/usr/you/passwd ; the second example first changes directory to I etc and 
then copies the file: 

cp /etc/passwd /usr/you/passwd 
(cd /etc; cp passwd /usr/you/passwd) 

Note the use of parentheses. Both command lines have the same effect. 
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If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), spelling 
correction is applied to each component of directory , in a search for the 
“correct” name. The shell then asks whether or not to try and change 
directory to the corrected directory name; an answer of n means “no”, and 
anything else is taken as “yes.” 


4.4.2 The .profile File 

The file named .profile is read each time you log in to XENIX. It is normally 
used to execute special one-time-only commands and to set and export 
variables to all later shells. Only after commands are read and executed 
from . profile , does the shell read commands from the standard input- 
usually the terminal. 


4.4.3 Execution Flags 

The set command lets you alter the behavior of the shell by setting certain 
shell flags. In particular, the — x and — v flags may be useful when invoking 
the shell as a command from the terminal. The flags -x and -v may be set 
by entering: 

set -xv 

The same flags may be turned off by entering: 
set +xv 


These two flags have the following meaning: 

-v Input lines are printed as they are read by the shell. This flag 

is particularly useful for isolating syntax errors. The com- 
mands on each input line are executed after that input line is 
printed. 

-x Commands and their arguments are printed as they are exe- 

cuted. (Shell control commands, such as for, while, etc., are 
not printed, however.) Note that — x causes a trace of only 
those commands that are actually executed, whereas — v 
prints each line of input until a syntax error is detected. 

The set command is also used to set these and other flags within shell pro- 
cedures. 


4-16 



The Shell 


4.5 A Command’s Environment 

All variables and their associated values that are known to a command at 
the beginning of its execution make up its environment. This environment 
includes variables that the command inherits from its parent process and 
variables specified as keyword parameters on the command line that 
invokes the command. 

The variables that a shell passes to its child processes are those that have 
been named as arguments to the export command. The export command 
places the named variables in the environments of both the shell and all its 
future child processes. 

Keyword parameters are variable-value pairs that appear in the form of 
assignments, normally before the procedure name on a command line. 
Such variables are placed in the environment of the procedure being 
invoked. For example: 

# keycommand 
echo $a $b 

This is a simple procedure that echoes the values of two variables. If it is 
invoked as: 

a=keyl b=key2 keycommand 
then the resulting output is: 
keyl key2 

Keyword parameters are not counted as arguments to the procedure and 
do not affect$#. 

A procedure may access the value of any variable in its environment. How- 
ever, if changes are made to the value of a variable, these changes are not 
reflected in the environment; they are local to the procedure in question. 
In order for these changes to be placed in the environment that the pro- 
cedure passes to its child processes, the variable must be named as an argu- 
ment to the export command within that procedure. To obtain a list of vari- 
ables that have been made exportable from the current shell, enter: 

export 
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You will also get a list of variables that have been made readonly. To get a 
list of name-value pairs in the current environment, enter either: 

printenv 

or 

env 


4.6 Invoking the Shell 

The shell is a command and may be invoked in the same way as any other 
command: 

sh proc [arg . . . ] A new instance of the shell is explicitly 

invoked to read proc. Arguments, if any, 
can be manipulated. 

sh -v proc [ arg . . . ] This is equivalent to putting “set -v” at the 

beginning of proc. It can be used in the 
same way for the — x, — e, — u, and — n 
flags. 

proc [arg. . . ] If proc is an executable file, and is not a 

compiled executable program, the effect is 
similar to that of: 

sh proc args 

An advantage of this form is that variables 
that have been exported in the shell will 
still be exported from proc when this form 
is used (because the shell only forks to 
read commands from proc). Thus any 
changes made within proc to the values of 
exported variables will be passed on to 
subsequent commands invoked from 
proc. 


4.7 Passing Arguments to Shell Procedures 

When a command line is scanned, any character sequence of the form $n is 
replaced by the nth argument to the shell, counting the name of the shell 
procedure itself as $0. This notation permits direct reference to the pro- 
cedure name and to as many as nine positional parameters. Additional 
arguments can be processed using the shift command or by using a for 
loop. 


4-18 



The Shell 


The shift command shifts arguments to the left; i.e., the value of $1 is 
thrown away, $2 replaces $1, $3 replaces $2, and so on. The highest- 
numbered positional parameter becomes unset ($0 is never shifted). For 
example, in the shell procedure ripple below, echo writes its arguments to 
the standard output. 

# ripple command 
while test $# != 0 
do 

echo $1 $2 $3 $4 $5 $6 $7 $8 $9 
shift 

done 

Lines that begin with a number sign (#) are comments. The looping com- 
mand, while, is discussed in Section 4.9.3 of this chapter. If the procedure 
were invoked with: 

ripple a b c 

it would print: 

ab c 
b c 
c 


The special shell variable “star” ($*) causes substitution of all positional 
parameters except $0. Thus, the echo line in the ripple example above 
could be written more compactly as: 

echo $* 


These two echo commands are not equivalent: the first prints at most nine 
positional parameters; the second prints all of the current positional 
parameters. The shell star variable ($*) is more concise and less error- 
prone. One obvious application is in passing an arbitrary number of argu- 
ments to a command. For example: 

wc $* 

counts the words of each of the files named on the command line. 

It is important to understand the sequence of actions used by the shell in 
scanning command lines and substituting arguments. The shell first reads 
input up to a newline or semicolon, and then parses that much of the input. 
Variables are replaced by their values and then command substitution (via 
back quotation marks) is attempted. I/O redirection arguments are 
detected, acted upon, and deleted from the command line. Next, the shell 
scans the resulting command line for internal field separators , that is, for 


4-19 



XENIX User’s Guide 


any characters specified by IFS to break the command line into distinct 
arguments; explicit null arguments (specified by "" or ") are retained, while 
implicit null arguments resulting from evaluation of variables that are null 
or not set are removed. Then filename generation occurs with all meta- 
characters being expanded. The resulting command line is then executed 
by the shell. 

Sometimes, command lines are built inside a shell procedure. In this case, 
it is sometimes useful to have the shell rescan the command line after all the 
initial substitutions and expansions have been performed. The special 
command eval is available for this purpose, eval takes a command line as 
its argument and simply rescans the line, performing any variable or com- 
mand substitutions that are specified. Consider the following (simplified) 
situation: 

command=who 
output=' | wc -r 
eval $command $output 

This segment of code results in the execution of the command line: 
who | wc -1 


The output of eval cannot be redirected. However, uses of eval can be 
nested, so that a command line can be evaluated several times. 


4.8 Controlling the Flow of Control 

The shell provides several commands that implement a variety of control 
structures useful in controlling the flow of control in shell procedures. 
Before describing these structures, a few terms need to be defined . 

A simple command is any single irreducible command specified by the 
name of an executable file. I/O redirection arguments can appear in a sim- 
ple command line and are passed to the shell, not to the command. 

A command is a simple command or any of the shell control commands 
described below. A pipeline is a sequence of one or more commands 
separated by vertical bars ( |). In a pipeline, the standard output of each 
command but the last is connected (by a pipe) to the standard input of the 
next command. Each command in a pipeline is run separately; the shell 
waits for the last command to finish. The exit status of a pipeline is 
nonzero if the exit status of either the first or last process in the pipeline is 
nonzero. 

A command list is a sequence of one or more pipelines separated by a semi- 
colon (;), an ampersand (&), an “and-if” symbol (&&), or an “or-if” ( 1 1) 
symbol, and optionally terminated by a semicolon or an ampersand. A 
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semicolon causes sequential execution of the previous pipeline. This 
means that the shell waits for the pipeline to finish before reading the next 
pipeline. On the other hand, the ampersand (&) causes asynchronous 
background execution of the preceding pipeline. Thus, both sequential 
and background execution are allowed. A background pipeline continues 
execution until it terminates voluntarily, or until its processes are killed. 

Other uses of the ampersand include off-line printing, background compi- 
lation, and generation of jobs to be sent to other computers. For example, 
if you enter: 

nohup cc prog.c& 

you may continue working while the C compiler runs in the background. A 
command line ending with an ampersand is immune to interrupts or quits 
that you might generate by typing INTERRUPT or QUIT. It is also immune 
to logouts with Ctrl-d. However, Ctrl-d mil abort the command if you are 
operating over a dial-up line. In this case, it is wise to make the command 
immune to hang-ups (i.e., logouts) as well. The nohup command is used 
for this purpose. In the above example without nohup, if you log out from 
a dial-up line while cc is still executing, cc will be killed and your output will 
disappear. 

The ampersand operator should be used with restraint, especially on 
heavily-loaded systems. Other users will not consider you a good citizen if 
you start up a large number of background processes without a compelling 
reason for doing so. 

The and -if and or-if (&& and 1 1) operators cause conditional execution of 
pipelines. Both of these are of equal precedence when evaluating com- 
mand lines (but both are lower than the ampersand (&) and the vertical bar 
(|)). In the command line: 

cmdl || cmd2 

the first command, cmdl, is executed and its exit status examined. Only if 
cmdl fails (i.e., has a nonzero exit status) is cmd2 executed. Thus, this is a 
more terse notation for: 

if cmdl 

test $? != 0 

then 

cmd2 

fi 
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The and-if operator (&&) yields a complementary test. For example, in 
the following command line: 

cmdl && cmd2 

the second command is executed only if the first succeeds (and has a zero 
exit status). In the sequence below, each command is executed in order 
until one fails: 

cmdl && cmd2 && cmd3 && ... && cmdn 

A simple command in a pipeline may be replaced by a command list 
enclosed in either parentheses or braces. The output of all the commands 
so enclosed is combined into one stream that becomes the input to the next 
command in the pipeline. The following line formats and prints two 
separate documents: 

{ nroff -mm textl; nroff -mm text2; } | lpr 

Note that a space is needed after the left brace and that a semicolon should 
appear before the right brace. 


4.8.1 Using the if Statement 

The shell provides structured conditional capability with the if command. 
The simplest if command has the following form : 

if command- list 
then command- list 

fi 

The command list following the if is executed and if the last command in 
the list has a zero exit status, then the command list that follows then is exe- 
cuted. The word fi indicates the end of the if command. 

To cause an alternative set of commands to be executed when there is a 
nonzero exit status, an else clause can be given with the following struc- 
ture: 


if command- list 
then command- list 
else 

command- list 

fi 

Multiple tests can be achieved in an if command by using the elif clause, 
although the case statement (See Section 7.9.2) is better for large numbers 
of tests. For example: 
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if 

test -f 

'$1" 




# 



is $1 a 

file? 


then 

pr $1 





elif 

test -d 

M $l' 




# 



else, is 

$1 a 

directory? 

then 

(cd $1; 

P r 

*) 



else 

echo $1 

is 

neither a 

file 

nor a directory 


fi 

The above example is executed as follows: if the value of the first positional 
parameter is a filename (-f), then print that file; if not, then check to see if 
it is the name of a directory (-d). If so, change to that directory (cd) and 
print all the files there (pr*). Otherwise, echo the error message. 

The if command may be nested (but be sure to end each one with a fi). The 
newlines in the above examples of if may be replaced by semicolons. 

The exit status of the if command is the exit status of the last command exe- 
cuted in any then clause or else clause. If no such command was executed, 
if returns a zero exit status. 

Note that an alternate notation for the test command uses brackets to 
enclose the expression being tested. For example, the previous example 
might have been written as follows: 


if 

[ -f "$i" ] 


# 

is $1 a file? 


then 

pr $1 


elif 

[ -d "$1" ] 


# 

else, is $1 a 

directory? 

then 

(cd $1; pr *) 


else 

echo $1 is neither a file 

nor a directory 


fi 

Note that a space after the left bracket and one before the right bracket are 
essential in this form of the syntax. 


4.8.2 Using the case Statement 

A multiple test conditional is provided by the case command. The basic 
format of the case statement is: 

case string in 

pattern ) command- list ;; 

pattern ) command- list ;; 

esac 
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The shell tries to match string against each pattern in turn, using the same 
pattern-matching conventions as in filename generation. If a match is 
found, the command list following the matched pattern is executed; the 
double semicolon (; ;) serves as a break out of the case and is required after 
each command list except the last. Note that only one pattern is ever 
matched, and that matches are attempted in order, so that if a star (*) is the 
first pattern in a case, no other patterns are looked at. 

More than one pattern may be associated with a given command list by 
specifying alternate patterns separated by vertical bars ( |). 

case $i in 

*.c) cc $i 

*.h | *.sh) 

: do nothing 

j > 

*) echo "$i of unknown type” 

> f 

esac 

In the above example, no action is taken for the second set of patterns 
because the null, colon (:) command is specified. The star (*) is used as a 
default pattern, because it matches any word. 

The exit status of case is the exit status of the last command executed in the 
case command. If no commands are executed, then case has a zero exit 
status. 


4.8.3 Conditional Looping: while and until 
A while command has the general form: 

while command- list 

do 

command- list 

done 

The commands in the first command- list are executed, and if the exit 
status of the last command in that list is zero, then the commands in the 
second command- list are executed. This sequence is repeated as long as 
the exit status of the first command- list is zero. A loop can be executed as 
long as the first command-list returns a nonzero exit status by replacing 
while with until. 
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Any newline in the above example may be replaced by a semicolon. The 
exit status of a while (or until) command is the exit status of the last com- 
mand executed in the second command- list. If no such command is exe- 
cuted, while (or until) has a zero exit status. 


4.8.4 Looping Over a List: for 

Often, one wishes to perform some set of operations for each file in a set of 
files, or execute some command once for each of several arguments. The 
for command can be used to accomplish this. The for command has the 
format: 

for variable in word- list 

do 

command- list 

done 

Here word- list is a list of strings separated by blanks. The commands in the 
command- list are executed once for each word in the word- list. Variable 
takes on as its value each word from the word list, in turn. The word list is 
fixed after it is evaluated the first time. For example, the following for loop 
causes each of the C source files xec.c, cmd.c , and word.c in the current 
directory to be compared with a file of the same name in the directory 
/ usr/src/cmd/sh : 

for CFILE in xec cmd word 

do diff ${ CFILE}. c /usr/src/cmd/sh/${CFILE}.c 
done 


Note that the first occurrence of CFILE immediately after the word for has 
no preceding dollar sign, since the name of the variable is wanted and not 
its value. 

You can omit the “in word- list” part of a for command; this causes the 
current set of positional parameters to be used in place of word-list. This is 
useful when writing a command that performs the same set of commands 
for each of an unknown number of arguments. 

Create a file named echo2 that contains the following shell script: 

for word 

do echo %word%word 
done 
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Give echo 2 execute status: 

chmod +x echo2 

Now type the following command : 

echo2 ma pa bo fi yo no so ta 

The output from this command is: 

mama 

papa 

bobo 

fifi 

yoyo 

nono 

soso 

tata 


4.8.5 Loop Control: break and continue 

The break command can be used to terminate execution of a while or a for 
loop. Continue requests the execution of the next iteration of the loop. 
These commands are effective only when they appear between do and 

done. 

The break command terminates execution of the smallest (i.e., innermost) 
enclosing loop, causing execution to resume after the nearest following 
unmatched done. Exit from n levels is obtained by break n . 

The continue command causes execution to resume at the nearest enclos- 
ing for, while, or until statement, i.e., the one that begins the innermost 
loop containing the continue. You can also specify an argument n to con- 
tinue and execution will resume at the nth enclosing loop : 
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# This procedure is interactive. 

# "Break" and "continue" commands are used 

# to allow the user to control data entry, 
while true #loop forever 

do echo "Please enter data" 
read response 
case "$response" in 
"done") break 

# no more data 

f i 

"") # just a carriage return, 

# keep on going 
continue 

» * 

*) # process the data here 

y y 

esac 

done 


4.8.6 End- of- File and exit 

When the shell reaches the end-of-file in a shell procedure, it terminates 
execution, returning to its parent the exit status of the last command exe- 
cuted prior to the end-of-file. The top level shell is terminated by typing a 
Ctrl-d which is the same as logging out. 

The exit command simply reads to the end-of-file and returns, setting the 
exit status to the value of its argument, if any. Thus, a procedure can be ter- 
minated normally by placing “exit 0” at the end of the file. 


4.8.7 Command Grouping: Parentheses and Braces 

There are two methods for grouping commands in the shell: parentheses 
and braces. Parentheses cause the shell to create a sub shell that reads the 
enclosed commands. Both the right and left parentheses are recognized 
wherever they appear in a command line-they can appear as literal 
parentheses only when enclosed in quotation marks. For example, if you 
enter: 


garble(stuff) 

the shell prints an error message. Quoted lines, such as: 

garble"("stuff")" 

“garble(stuff)” 
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are interpreted correctly. Other quoting mechanisms are discussed in sec- 
tions 4.17, 7.18 and 7.21 of this book. 

This capability of creating a subshell by grouping commands is useful when 
performing operations without affecting the values of variables in the 
current shell, or when temporarily changing the working directory and exe- 
cuting commands in the new directory without having to return to the 
current directory. 


The current environment is passed to the subshell and variables that are 
exported m the current shell are also exported in the subshell. Thus: 


CURRENTDIR='pwd'; cd /usr/docs/otherdir; 
nohup nroff doc.n | lpr&; cd SCURRENTDIR 


and 


(cd/O/usr/docs/ otherdir; nohup nroff doc.n | Ipr&) 

accomplish the same result: a copy of lusrl docs! otherdir I, doc.n is sent to 
ineprinter. (Note that nroff is a command available in the XENIX Text 
recessing System.) However, the second example automatically puts you 
back m your original working directory. In the second example above, 
Wh n ; neS SUrroundln § the Parentheses are allowed but not neces- 
ent f yi ng u C ?, mm - a ? d hne at y° ur terminal, the shell will prompt 
t the value of the shell variable PS2 if an end parenthesis is expected . 

Pff C ® S T,u nd als ° be used to 8 rou P commands together. Both the 

left and the right brace are recognized only if they appear as the first 

( nquoted) word of a command. The opening brace may be followed by a 

newline (m which case the shell prompts for more input). Unlike 
parentheses no subshell is created for braces: the enclosed commands are 
simp y read by the shell The braces are convenient when you wish to use 
the (sequential) output of several commands as input to one command. 

The exit status of a set of commands grouped by either parentheses or 

braces is the exit status of the last enclosed executed command. 


4.8.8 Input/Output Redirection and Control Commands 

The shell normally does not fork and create a new shell when it recognizes 
the control commands (other than parentheses) described above. How- 
^ t each command m a pipeline is run as a separate process in order to 

mnn/ PU J t0 /? r outp “ t ^ rom each command. Also, when redirection of 
mput or output is specified explicitly to a control command, a separate pro- 
cess is spawned to execute that command. Thus, when if, while until 
case and for are used in a pipeline consisting of more than one command’ 

implications-^ 3 SUbSheU mnS the COntro1 command - This has two 
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1. Any changes made to variables within the control command are not 
effective once that control command finishes (this is similar to the 
effect of using parentheses to group commands). 

2. Control commands run slightly slower when redirected, because of 
the additional overhead of creating a shell for the control com- 
mand. 


4.8.9 Transfer Between Files: The Dot (.) Command 

A command line of the form : 

. proc 

causes the shell to read commands from proc without spawning a new pro- 
cess. Changes made to variables in proc are in effect after the dot com- 
mand finishes. This is a good way to gather a number of shell variable ini- 
tializations into one file. A common use of this command is to reinitialize 
the top level shell by reading the .profile file with: 

. .profile 


4.8.10 Interrupt Handling: trap 

Shell procedures can use the trap command to disable a signal (cause it to 
be ignored), or redefine its action. The form of the trap command is: 

trap arg signal- list 

Here arg is a string to be interpreted as a command list and signal- list con- 
sists of one or more signal numbers as described in signal (S)) in the 
XENIX Reference Manual. The most important of these signals follow: 


Number 

Signal 

00 

Exit from the shell 

01 

HANGUP 

02 

INTERRUPT character (DELETE or RUB OUT) 

03 

QUIT (Ctrl-\) 

09 

KILL (cannot be caught or ignored) 

11 

segmentation violation (cannot be caught or ignored) 

15 

software termination signal 


The commands in arg are scanned at least once, when the shell first 
encounters the trap command. Because of this, it is usually wise to use sin- 
gle rather than double quotation marks to surround these commands. The 
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former inhibit immediate command and variable substitution. This 
becomes important, for instance, when one wishes to remove temporary 
files and the names of those files have not yet been determined when the 
trap command is first read by the shell. The following procedure will print 
the name of the current directory in the file err direct when it is interrupted, 
thus giving the user information as to how much of the job was done : 

trap "echo pwd' >errdirect" 2 3 15 
for i in /bin /usr/bin /usr/gas/bin 
do 

cd $i 

# commands to be executed in directory $i here 

done 


Beware that the same procedure with double rather than single quotation 
marks does something different. The following prints the name of the 
directory from which the procedure was first executed : 

(trap "echo pwd v >errdirect" 2 3 15) 

A signal 11 can never be trapped, because the shell itself needs to catch it 
to deal with memory allocation. Zero is interpreted by the trap command 
as a signal generated by exiting from a shell. This occurs either with an exit 
command, or by falling through” to the end of a procedure. If arg is not 
specified, then the action taken upon receipt of any of the signals in the sig- 
nallist is reset to the default system action. If arg is an explicit null string ( "" 
or ), then the signals in the signal list are ignored by the shell. 

The trap command is most frequently used to make sure that temporary 
files are removed upon termination of a procedure. The preceding exam- 
ple would b e written more typically as follows : 

temp=$H OME/temp/$$ 

trap "rm $temp; trap 0; exit" 0 1 2 3 15 

Is > $temp 

# commands that use $temp here 


In this example, whenever signal 1 (hangup), 2 (interrupt), 3 (quit), or 
15(terminate) is received by the shell procedure, or whenever the shell pro- 
cedure is about to exit, the commands enclosed between the single quota- 
tion marks are executed. The exit command must be included, or else the 
shell continues reading commands where it left off when the signal was 
received. The “trap 0” in the above procedure turns off the original traps 
1> 2, 3, and 15 on exits from the shell, so that the exit command does not 
reactivate the execution of the trap commands. 

Sometimes the shell continues reading commands after executing trap 
commands. The following procedure takes each directory in the current 
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directory, changes to that directory, prompts with its name, and executes 
commands typed at the terminal until an end-of-file (Ctrl-D) or an inter- 
rupt is received. An end-of-file causes the read command to return a 
nonzero exit status, and thus the while loop terminates and the next direc- 
tory cycle is initiated . An interrupt is ignored while executing the requested 
commands, but causes termination of the procedure when it is waiting for 
input: 

d= v pwd' 
for i in* 

do if test -d $d/$i 
then cd $d/$i 


while 

echo "$i:" 
trap exit 2 
read x 

do 

trap : 2 

# ignore interrupts 


eval $x 

done 



fi 

done 

Several traps may be in effect at the same time: if multiple signals are 
received simultaneously, they are serviced in numerically ascending order. 
To determine which traps are currently set, enter: 

trap 


It is important to understand some things about the way in which the shell 
implements the trap command. When a signal (other than 11) is received 
by the shell, it is passed on to whatever child processes are currently exe- 
cuting. When these (synchronous) processes terminate, normally or 
abnormally, the shell polls any traps that happen to be set and executes the 
appropriate trap commands. This process is straightforward, except in the 
case of traps set at the command (outermost, or login) level. In this case, it 
is possible that no child process is running, so before the shell polls the 
traps, it waits for the termination of the first process spawned after the sig- 
nal was received. 

When a signal is redefined in a shell script, this does not redefine the signal 
for programs invoked by that script; the signal is merely passed along. A 
disabled signal is not passed. 

For internal commands, the shell normally polls traps on completion of 
the command. An exception to this rule is made for the read command, 
for which traps are serviced immediately, so that read can be interrupted 
while waiting for input. 
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4.9 Special Shell Commands 

There are several special commands that are internal to the shell, some of 
which have already been mentioned. The shell does not fork to execute 
these commands, so no additional processes are spawned. These com- 
mands should be used whenever possible, because they are, in general, fas- 
ter and more efficient than other XENIX commands. The trade-off for this 
efficiency is that redirection of input and output is not allowed for most of 
these special commands. 

Several of the special commands have already been described because they 
affect the flow of control. They are dot ( . ), break, continue, exit, and 
trap. The set command is also a special command. Descriptions of the 
remaining special commands are given here: 

• The null command. This command does 

nothing and can be used to insert comments 
in shell procedures. Its exit status is zero 
(true). Its utility as a comment character has 
largely been supplanted by the number sign 
(#) which can be used to insert comments to 
the end-of-line. Beware: any arguments to 
the null command are parsed for syntactic 
correctness; when in doubt, quote such argu- 
ments. Parameter substitution takes place, 
just as in other commands. 

cd ar s Make arg the current directory. Ifargisnota 

valid directory, or the user is not authorized to 
access it, a nonzero exit status is returned. 
Specifying cd with no arg is equivalent to 
entering “cd $HOME” which takes you to 
your home directory. 

exec arg ... If a rg is a command, then the shell executes 

the command without forking and returning 
to the current shell. This is effectively a 
“goto” and no new process is created. Input 
and output redirection arguments are allowed 
on the command line. If only input and out- 
put redirection arguments appear, then the 
input and output of the shell itself are 
modified accordingly. 

newgrp arg . . . The newgrp command is executed, replacing 

the shell. Newgrp in turn creates a new shell. 
Beware: only environment variables will be 
known in the shell created by the newgrp 
command. Any variables that were exported 
will no longer be marked as such. 
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read var . . . 


readonly var . . . 


times 


ulimit 


umask nnn 


wait 


One line (up to a newline) is read from the 
standard input and the first word is assigned 
to the first variable, the second word to the 
second variable, and so on. All words left 
over are assigned to the /^variable. The exit 
status of read is zero unless an end-of-file is 
read. 

The specified variables are made readonly so 
that no subsequent assignments maybe made 
to them. If no arguments are given, a list of all 
readonly and of all exported variables is 
given. 

The accumulated user and system times for 
processes run from the current shell are 
printed. 

This imposes a size limit of n blocks on files 
written. The -f flag imposes a size limit of n 
blocks on files written by child processes (files 
of any size may be read). With no argument, 
the current limit is printed. If no option is 
given and a number is specified, -f is 
assumed. 

The user file creation mask is set to nnn. If 
nnn is omitted, then the current value of the 
mask is printed. This bit-mask is used to set 
the default permissions when creating files. 
For example, ' an v octal umask of 137 
corresponds to the following bit-mask and 
permission settings for a newly created file: 


User 

user 

group 

other 

Octal 

1 

3 

7 

bit-mask 

001 

Oil 

111 

permissions 

rw- 

r- - 

— 


See umask(C) in the XENIX Reference 
Manual for information on the value of nnn. 

The shell waits for all currently active child 
processes to terminate. If n is specified, the 
shell waits for the specified process to ter- 
minate, and reports the termination status. 
The exit status of wait is always zero. 
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4. 10 Creation and Organization of Shell Procedures 

A shell procedure can be created in two simple steps. The first is building 
an ordinary text file. The second is changing the mode of the file to make it 
executable , thus permitting it to be invoked by: 

proc args 

rather than 

sh proc args 


The second step may be omitted for a procedure to be used once or twice 
and then discarded, but is recommended for frequently-used ones. To set 
up a simple procedure, first create a file named mailall with the following 
contents: 

LETTER=$1 

shift 

for i in $* 

do mail $i < $LETTER 
done 


Next enter: 

chmod +x mailall 


The new command might then be invoked from within the current direc- 
torybyentering: 

mailall letter joe bob 

Here letter is the name of the file containing the message you want to send, 
and joe and bob are people you want to send the message to. Note that 
shell procedures must always be at least readable, so that the shell itself can 
read commands from the file. 

If mailall were thus created in a directory whose name appears in the user’s 
PATH variable, the user could change working directories and still invoke 
the mailall command. 

Shell procedures are often used by users running the csh. However, if the 
first character of the procedure is a # (comment character), the csh 
assumes the procedure is a csh script, and invokes /bin/csh to execute it. 
Always start sh procedures with some other character if csh users are to 
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run the procedure at any time. This invokes the standard shell / bin/sh . 
Shell procedures may be created dynamically. A procedure may generate 
a file of commands, invoke another instance of the shell to execute that 
file, and then remove it. An alternate approach is that of using the dot 
command (.) to make the current shell read commands from the new file, 
allowing use of existing shell variables and avoiding the spawning of an 
additional process for another shell. 

Many users prefer writing shell procedures to writing C programs. This is 
true for several reasons: 

1. A shell procedure is easy to create and maintain because it is only a 
file of ordinary text. 

2. A shell procedure has no corresponding object program that must 
be generated and maintained. 

3. A shell procedure is easy to create quickly, use a few times, and then 
remove. 

4. Because shell procedures are usually short in length, written in a 
high-level programming language, and kept only in their source- 
language form, they are generally easy to find, understand, and 
modify. 

By convention, directories that contain only commands and shell pro- 
cedures are named bin. This name is derived from the word “binary”, and 
is used because compiled and executable programs are often called 
“binaries” to distinguish them from program source files. Most groups of 
users sharing common interests have one or more bin directories set up to 
hold common procedures. Some users have their PATH variable list 
several such directories. Although you can have a number of such direc- 
tories, it is unwise to go overboard: it may become difficult to keep track of 
your environment and efficiency may suffer. 


4.11 More About Execution Flags 

There are several execution flags available in the shell that can be useful in 
shell procedures: 

-e This flag causes the shell to exit immediately if any command 

that it executes exits with a nonzero exit status. This flag is 
useful for shell procedures composed of simple command 
lines; it is not intended for use in conjunction with other con- 
ditional constructs. 
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This flag causes unset variables to be considered errors when 
substituting variable values. This flag can be used to effect a 
global check on variables, rather than using conditional sub- 
stitution to check each variable. 

This flag causes the shell to exit after reading and executing 
the commands on the remainder of the current input line. 
This flag is typically used by C programs which call the shell 
to execute a single command. 

This is a don t execute” flag. On occasion, one may want to 
check a procedure for syntax errors, but not execute the 
commands in the procedure. Using “set-nv” at the begin- 
ning of a file will accomplish this. 

This flag causes all arguments of the form variable=value to 
be treated as keyword parameters. When this flag is not set 
only such arguments that appear before the command name 
are treated as keyword parameters. 


4.12 Supporting Commands and Features 


S hel1 procedures can make use of any XENIX command. The commands 
described in this section are either used especially frequently in shell pro- 
cedures, or are explicitly designed for such use. 


4.12.1 Conditional Evaluation: test 

The test command evaluates the expression specified by its arguments and 
if the expression is true, test returns a zero exit status. Otherwise a 
nonzero (fake) exit status is returned, test also returns a nonzero exit 
status if it has no arguments. Often it is convenient to use the test com- 
mand as the first command in the command list following an if or a while 
Shell variables used in test expressions should be enclosed in double quo- 
tation marks if there is any chance of their being null or not set. 

The square brackets maybe used as an alias to test, so that: 

[expression] 

has the same effect as: 

test expression 

Note that the spaces before and after the expression in brackets are essen- 
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The following is a partial list of the options that can be used to construct a 
conditional expression : 


-r file 

True if the named file exists and is readable by the 
user. 

-w file 

True if the named file exists and is writable by the user. 

-x file 

True if the named file exists and is executable by the 
user. 

-s file 

True if the named file exists and has a size greater than 
zero. 

-d file 

True if the named file is a directory. 

-f file 

True if the named file is an ordinary file. 

-z sl 

True if the length of strings,/ is zero. 

-n si 

True if the length of the string sl is nonzero. 

-t fildes 

True if the open file whose file descriptor number is 
fildes is associated with a terminal device. If fildes is 
not specified, file descriptor 1 is used by default. 

H 

05 

True if strings sl and s2 are identical. 

sl \=s2 

True if strings sl and s2 are not identical. 

si 

True if sl is not the null string. 

nl — eq 

n2 True if the integers nl and n2 are algebraically equal; 

other algebraic comparisons are indicated by — ne 
(not equal), — gt (greater than), — ge (greater than or 
equal to), —It (less than ), and — le (less than or equal 
to). 

These may b' 

e combined with the following operators: 

t 

Unary negation operator. 

-a 

Binary logical AND operator. 

-0 

Binary logical OR operator; it has lower precedence 
than the logical AND operator (-a). 

{expr) 

Parentheses for grouping; they must be escaped to 
remove their significance to the shell. In the absence 
of parentheses, evaluation proceeds from left to right. 
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Note that all options, operators, filenames, etc. are separate arguments to 
test. 


4.12.2 Echoing Arguments 
The echo command has the following syntax: 
echo [options] [args] 

echo copies its arguments to the standard output, each followed by a single 
space, except for the last argument, which is normally followed by a new- 
line. You can use it to prompt the user for input, to issue diagnostics in 
shell procedures, or to add a few lines to an output stream in the middle of 
a pipeline. Another use is to verify the argument list generation process 
before issuing a command that does something drastic. 

You can replace the Is command with 

echo * 

because the latter is faster and prints fewer lines of output. 

The — n option to echo removes the newline from the end of the echoed 
line. Thus, the following two commands prompt for input and then allow 
entering on the same line as the prompt: 

echo -n "enter name:" 
read name 

The echo command also recognizes several escape sequences described in 
echo (C) in the XENIX Reference Manual. 


4.12.3 Expression Evaluation: expr 

The expr command provides arithmetic and logical operations on integers 
and some pattern-matching facilities on its arguments. It evaluates a single 
expression and writes the result on the standard output; expr can be used 
inside grave accents to set a variable. Some typical examples follow: 

# increment $A 
A='expr $a + l v 

# put third through last characters of 

# $1 into substring 
substring='expr "$1" : "..\(.*\) 

# obtain length of $1 
c='expr "$1" : 
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The most common uses of expr are in counting iterations of a loop and in 
using its pattern-matching capability to pick apart strings. 


4.12.4 True and False 

The true and false commands perform the functions of exiting with zero 
and nonzero exit status, respectively. The true and false commands are 
often used to implement unconditional loops. For example, you might 
enter: 


while true 

do echo forever 
done 

This will echo “forever” on the screen until an INTERRUPT is entered. 


4.12.5 In- Line Input Documents 

Upon seeing a command line of the form : 
command < < eof string 

where eofstring is any arbitrary string, the shell will take the subsequent 
lines as the standard input of command until a line is read consisting only of 
eofstring. (By appending a minus (-) to the input redirection symbol 
(< <), leading spaces and tabs are deleted from each line of the input docu- 
ment before the shell passes the line to command.) 

The shell creates a temporary file containing the input document and per- 
forms variable and command substitution on its contents before passing it 
to the command. Pattern matching on filenames is performed on the argu- 
ments of command lines in command substitutions. In order to prohibit all 
substitutions, you may quote any character of eofstring: 

command << \eofstring 


The in-line input document feature is especially useful for small amounts 
of input data, where it is more convenient to place the data in the shell pro- 
cedure than to keep it in a separate file. For instance, you could enter: 

cat <<- xx 

This message will be printed on the 
terminal with leading tabs and spaces 
removed, 
xx 
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This in-line input document feature is most useful in shell procedures. 
Note that in-line input documents may not appear within grave accents. 


4. 12.6 Input / Output Redirection Using File Descriptors 

We mentioned above that a command occasionally directs output to some 
file associated with a file descriptor other than 1 or 2. In languages such as 
C, one can associate output with any file descriptor by using the 

write (S) system call (see the XENIX Reference Manual). The shell pro- 
vides its own mechanism for creating an output file associated with a partic- 
ular file descriptor. By entering: 

fdl >&fd2 

where fdl and fd2 are valid file descriptors, one can direct output that 
would normally be associated with file descriptor /di to the file associated 
with fd2. The default value for fdl andjfi/2 is 1. If, at run time, no file is 
associated with fd2, then the redirection is void. The most common use of 
this mechanism is that of directing standard error output to the same file as 
standard output. This is accomplished by entering: 

command 2>&1 

If you wanted to redirect both standard output and standard error output 
to the same file, you would enter: 

command l>file 2>&1 

The order here is significant: first, file descriptor 1 is associated with file; 
then file descriptor 2 is associated with the same file as is currently associ- 
ated with file descriptor 1. If the order of the redirections were reversed, 
standard error output would go to the terminal, and standard output would 
go to file, because at the time of the error output redirection, file descriptor 
1 still would have been associated with the terminal. 

This mechanism can also be generalized to the redirection of standard 
input. You could enter: 

fda <& fdb 

to cause both file descriptors fda and fdb to be associated with the same 
input file. If fda or fdb is not specified, file descriptor 0 is assumed. Such 
input redirection is useful for a command that uses two or more input 
sources. 
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4.12.7 Conditional Substitution 

Normally, the shell replaces occurrences of %variable by the string value 
assigned to variable, if any. However, there exists a special notation to 
allow conditional substitution, dependent upon whether the variable is set 
or not null. By definition, a variable is set if it has ever been assigned a 
value. The value of a variable can be the null string, which may be assigned 
to a variable in anyone of the following ways: 

A= 

bcd="" 

efg=~ 


The first three examples assign null to each of the corresponding shell vari- 
ables. The last example sets the first and second positional parameters to 
null. The following conditional expressions depend upon whether a vari- 
able is set and not null. Note that the meaning of braces in these expres- 
sions differs from their meaning when used in grouping shell commands. 
Parameter as used below refers to either a digit or a variable name. 

%{variable ’-string} If variable is set and is nonnull, then substi- 
tute the value $ variable in place of this 
expression. Otherwise, replace the expres- 
sion with string. Note that the value of vari- 
able is not changed by the evaluation of this 
expression. 

${variable :=string } If variable is set and is nonnull, then substi- 

tute the value ivariable in place of this 
expression. Otherwise, set variable to 
string, and then substitute the value ivari- 
able in place of this expression. Positional 
parameters may not be assigned values in 
this fashion. 

${variable :? string} If variable is set and is nonnull, then substi- 

tute the value of variable for the expression. 
Otherwise, print a message of the form 

variable : string 

and exit from the current shell. (If the shell 
is the login shell, it is not exited.) If string is 
omitted in this form, then the message 

variable : parameter null or not set 
is printed instead . 
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%{variable :+string} If variable is set and is nonnull, then substi- 
tute string for this expression. Otherwise, 
substitute the null string. Note that the value 
of variable is not altered by the evaluation of 
this expression. 

These expressions may also be used without the colon. In this variation, 
the shell does not check whether the variable is null or not; it only checks 
whether the variable has ever been set. 

The two examples b elo w illustrate the use of this facility: 

1. This example performs an explicit assignment to the PATH vari- 
able: 

“PATH”=${PATH:-':/bin:/usr/bnT} 

This says, if PATH has ever been set and is not null, then it keeps its 
current value; otherwise, set it to the string “ :/bin :/usr/bin”. 

2. This example automatically assigns the HOME variable a value: 

cd ${HOME:=7usr/gas'} 

If HOME is set, and is not null, then change directory to it. Other- 
wise set HOME to the given value and change directory to it. 


4.12.8 Invocation Flags 

There are five flags that may be specified on the command line when invok- 
ing the shell. These flags may not be turned on with the set command: 

— i If this flag is specified, or if the shell’s input and output are 

both attached to a terminal, the shell is interactive. In such a 
shell, INTERRUPT (signal 2) is caught and ignored, and 
TERMINATE (signal 15) and QUIT (signal 3) are ignored. 

— s If this flag is specified or if no input/output redirection argu- 

ments are given, the shell reads commands from standard 
input. Shell output is written to file descriptor 2. The shell 
you get upon logging into the system has the — s flag turned 
on. 

-c When this flag is turned on, the shell reads commands from 

the first string following the flag. Remaining arguments are 
ignored. Double quotation marks should be used to enclose 
amultiword string, in orderto allow for variable substitution. 


4-42 



The Shell 


- 1 When this flag is on, a single command is read and executed, 

then the shell exits. This flag is not useful interactively, but is 
intended for use with C programs. 

-r If this flag is present the shell is a restricted shell (see rsh 

(C)). 


4. 13 Effective and Efficient Shell Programming 

This section outlines strategies for writing efficient shell procedures, ones 
that do not waste resources in accomplishing their purposes. The primary 
reason for choosing a shell procedure to perform a specific function is to 
achieve a desired result at a minimum human cost. Emphasis should 
always be placed on simplicity, clarity, and readability, but efficiency can 
also be gained through awareness of a few design strategies. In many cases, 
an effective redesign of an existing procedure improves its efficiency by 
reducing its size, and often increases its comprehensibility. In any case, 
you should not worry about optimizing shell procedures unless they are 
intolerably slow or are known to consume an inordinate amount of a 
system’s resources. 

The same kind of iteration cycle should be applied to shell procedures as to 
other programs: write code, measure it, and optimize only the few impor- 
tant parts. The user should become familiar with the time command, 
which can be used to measure both entire procedures and parts thereof. Its 
use is strongly recommended; human intuition is notoriously unreliable 
when used to estimate timings of programs, even when the style of pro- 
gramming is a familiar one. Each timing test should be run several times, 
because the results are easily disturbed by variations in system load. 


4.13.1 NumberofProcesses Generated 

When large numbers of short commands are executed, the actual execu- 
tion time of the commands may well be dominated by the overhead of 
creating processes. The procedures that incur significant amounts of such 
overhead are those that perform much looping, and those that generate 
command sequences to be interpreted by another shell. 

If you are worried about efficiency, it is important to know which com- 
mands are currently built into the shell, and which are not. Here is the 
alphabetical list of those that are built in: 
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break 

case 

cd 

continue 

eval 

exec 

exit 

export 

for 

if 

newgrp 

read 

readonly 

set 

shift 

test 

times 

trap 

umask 

until 

wait 

while 


o 


Parentheses, (), are built into the shell, but commands enclosed within 
them are executed as a child process, i.e., the shell does a fork, but no 
exec. Any command not in the above list requires both fork and exec. 

The user should always have at least a vague idea of the number of 
processes generated by a shell procedure. In the bulk of observed pro- 
cedures, the number of processes created (not necessarily simultaneously) 
can be described by: 

processes = (k *n) + c 

where k and c are constants, and n may be the number of procedure argu- 
ments, the number of lines in some input file, the number of entries in 
some directory, or some other obvious quantity. Efficiency improvements 
are most commonly gained by reducing the value of k, sometimes to zero. 

Any procedure whose complexity measure includes n ~ 2 terms or higher 
powers of n is likely to b e intolerably expensive. 

As an example, here is an analysis of a procedure named split , whose text is 
given below: 
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# split 

trap "rm temp$$; trap 0; exit" 0 1 2 3 15 
startl=0 start2=0 
b="[A-Za-z]" 
cat > temp$$ 

# read stdin into temp file 

# save original lengths of $1, $2 
if test -s "$1" 

then startl='wc -1 < $1' 
fi 

if test -s "$2" 

then start2='wc -1 < $2' 

fi 

grep "$b" temp$$ >> $1 

# lines with letters onto $1 
grep -v "$b" temp$$ | grep "[0-9]" >> $2 

# lines with only numbers onto $2 

total=" ‘wc -1 < emp$$'" 

endl=" ‘wc -1 < $r" 
end2=" ‘wc -1 < $2 V " 

lost= M ‘expr $total - \($endl - $startl\) \ 

- \($end2 - $start2\)' H 

echo "$total read, $lost thrown away” 


For each iteration of the loop, there is one expr plus either an echo or 
another expr. One additional echo is executed at the end. If n is the 
number of lines of input, the number of processes is 2*n + 1. 

Some types of procedures should not be written using the shell. For exam- 
ple, if one or more processes are generated for each character in some file, 
it is a good indication that the procedure should be rewritten in C. Shell 
procedures should not be used to scan or build files a character at a time. 


4.13.2 Numberof Data Bytes Accessed 

It is worthwhile to consider any action that reduces the number of bytes 
read or written. This may be important for those procedures whose time is 
spent passing data around among a few processes, rather than in creating 
large numbers of short processes. Some filters shrink their output, others 
usually increase it. It always pays to put the shrinkers first when the order is 
irrelevant. For instance, the second of the following examples is likely to 
be faster because the input to sort will be much smaller: 

sort file | grep pattern 

grep pattern file | sort 
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4.13.3 Shortening Directory Searches 

Directory searching can consume a great deal of time, especially in those 
applications that utilize deep directory structures and long pathnames. 
Judicious use of cd, the change directory command, can help shorten long 
pathnames and thus reduce the number of directory searches needed. As 
an exercise, try the following commands: 

Is -1 /usr/bin/* >/dev/null 
cd /usr/bin; Is -1 * >/dev/null 

The second command will run faster because of the fewer directory 
searches. 


4.13.4 Directory- Search Order and the PATH Variable 

The PATH variable is a convenient mechanism for allowing organization 
and sharing of procedures. However, it must be used in a sensible fashion, 
or the result may be a great increase in system overhead. 

The process of finding a command involves reading every directory 
included in every pathname that precedes the needed pathname in the 
current PATH variable. As an example, consider the effect of invoking 
nroff (i.e., /usr/bin! nr off) when the value of PATH is “:/bin:/usr/bin”. 
The sequence of directories read is: 

/ 

/bin 

/ 

/usr 

/usr/bin 


This is a total of six directories. A long path list assigned to PATH can 
increase this number significantly. 

The vast majority of command executions are of commands found in /bin 
and, to a somewhat lesser extent, in / usr/bin . Careless PATH setup may 
lead to a great deal of unnecessary searching. The following four examples 
are ordered from worst to best with respect to the efficiency of command 
searches: 
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:/ usr/john/bin :/usr/localb in :/b in :/usr/b in 
:/bin:/usr/john/bin:/usr/localbin:/usr/bin 
:/b in : /usr/b in : /usr/ j ohn/b in : / usr/lo c alb in 
/b in : : /u sr/b in : /usr/ j ohn/b in : / usr/lo c alb in 


The first one above should be avoided. The others are acceptable and the 
choice among them is dictated by the rate of change in the set of commands 
kept in I bin and I usr I bin. 

A procedure that is expensive because it invokes many short-lived com- 
mands may often be speeded up by setting the PATH variable inside the 
procedure so that the fewest possible directories are searched in an 
optimum order. 


4.13.5 Good Ways to SetUp Directories 

It is wise to avoid directories that are larger than necessary. You should be 
aware of several special sizes. A directory that contains entries for up to 30 
files (plus the required . and ..) fits in a single disk block and can be 
searched very efficiently. One that has up to 286 entries is still a small direc- 
tory; anything larger is usually a disaster when used as a working directory. 
It is especially important to keep login directories small, preferably one 
block at most. Note that, as a rule, directories never shrink. This is very 
important to understand, because if your directory ever exceeds either the 
30 or 286 thresholds, searches will be inefficient; furthermore, even if you 
delete files so that the number of files is less than either threshold, the sys- 
tem will still continue to treat the directory inefficiently. 


4.14 Shell Procedure Examples 

The power of the XENIX shell command language is most readily seen by 
examining how XENIX’S many labor-saving utilities can be combined to 
perform powerful and useful commands with very little programming 
effort. This section gives examples of procedures that do just that. By 
studying these examples, you will gain insight into the techniques and 
shortcuts that can be used in programming shell procedures (also called 
“scripts”). Note the use of the null command (:) to begin each shell pro- 
cedure and the use of the number sign (#) to introduce comments. 

It is intended that the following steps be carried out for each procedure: 

1. Place the procedure in a file with the indicated name. 

2. Give the file execute permission with the chmod command. 

3. Move the file to a directory in which commands are kept, such as 
your own bin directory. 
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4. Make sure that the path of the bin directory is specified in the PATH 
variable found in .profile. 

5. Execute the named command. 


BINUNIQ 


Is /bin /usr/bin | sort | uniq -d 

This procedure determines which files are in both /bin and /usr/bin. It is 
done because files in /bin will “override” those in /usr/bin during most 
searches and duplicates need to be weeded out. If the /usr/bin file is 
obsolete, then space is being wasted; if the /bin file is outdated by a 
corresponding entry in /usr/bin then the wrong version is being run and, 
again, space is being wasted. This is also a good demonstration of “sort | 
uniq” to find matches and duplications. 


COPYPAIRS 


# Usage: copypairs filel file2 ... 

# Copies filel to file2, file3 to file4, ... 
while test "$2" != "" 

do 

cp $1 $2 
shift; shift 

done 

if test "$1" != ,,M 

then echo M $0: odd number of arguments" 
fi 


This procedure illustrates the use of a while loop to process a list of posi- 
tional parameters that are somehow related to one another. Here a while 
loop is much better than a for loop, because you can adjust the positional 
parameters with the shift command to handle related arguments. 
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COPYTO 


# Usage: copyto dir file ... 

# Copies argument files to "dir", 

# making sure that at least 

# two arguments exist, that "dir" is a directory, 

# and that each additional argument 

# is a readable file. 

if test $# -It 2 „ 

then echo "$0: usage: copyto directory file ... 

elif test ! -d $1 

then echo "$0: $1 is not a directory ; 
else dir=$l; shift 

for eachfile 

do cp $eachfile $dir 

done 

fi 

This procedure uses an if command with several parts to screen out 
improper usage. The for loop at the end of the procedure loops over all of 
the arguments to copyto but the first; the original $1 is shifted off. 


DISTINCTl 


# Usage: distinctl 

# Reads standard input and reports list of 

# alphanumeric strings that differ only in case, 

# giving lowercase form of each . 
tr -cs 'A-Za-z0-9"\012' | sort-u|\ 
tr A-Z"a-z' | sort | uniq -d 


This procedure is an example of the kind of process that is created by the 
left-to-right construction of a long pipeline. Note the use of the backslash 
at the end of the first line as the line continuation character. It may not be 
immediately obvious how this command works. You may wish to consult 
tr (C), sort (C), and uniq (C) in the XENIX Reference Manual if you are 
completely unfamiliar with these commands. The tr command translates 
all characters except letters and digits into newline characters, and then 
squeezes out repeated newline characters. This leaves each string (in this 
case, any contiguous sequence of letters and digits) on a separate line. The 
sort command sorts the lines and emits only one line from any sequence of 
one or more repeated lines. The next tr converts everything to lowercase, 
so that identifiers differing only in case become identical. The output is 


4-49 



XENIX User’s Guide 


sorted again to bring such duplicates together. The “uniq-d” prints 
(once) only those lines that occur more than once, yielding the desired list. 

The process of building such a pipeline relies on the fact that pipes and files 
can usually be interchanged. The first line below is equivalent to the last 
two lines, assuming that sufficient disk space is available: 

cmdl | cmd2 | cmd3 

cmdl > tempi; < tempi cmd2 > temp2; < temp2 cmd3 
rm temp[123] 

Starting with a file of test data on the standard input and working from left 
to right, each command is executed taking its input from the previous file 
and putting its output in the next file. The final output is then examined to 
make sure that it contains the expected result. The goal is to create a series 
of transformations that will convert the input to the desired output. 

Although pipelines can give a concise notation for complex processes, you 
should exercise some restraint, since such practice often yields 
incomprehensible code. 


DRAFT 


# Usage: draft file(s) 

# Print manual pages for Diablo printer, 
fori in $* 

do nroff -man $i | lpr 

done 


Users often write this kind of procedure for convenience in dealing with 
commands that require the use of distinct flags that cannot be given default 
values that are reasonable for all (or even most) users. 


4-50 



The Shell 


# Usage: edfind file arg 

# Finds the last occurrence in "file” of a line 

# whose beginning matches "arg", then prints 

# 3 lines (the one before, the line itself, 

# and the one after) 
ed - $1<< —EOF 

?~$ 2 ? 

”>+P 

q 

EOF 


This illustrates the practice of using ed in-line input scripts into which the 
shell can substitute the values of variables. 


EDLAST 


# Usage: edlast file 

# Prints the last line of file, 

# then deletes that line, 
ed - $1 <<-\! 

$p 

$d 

w 

q 

I 

echo done 


This procedure illustrates taking input from within the file itself up to the 
exclamation point ( ! ). Variable substitution is prohibited within the input 
text because of the backslash. 
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# Usage: fsplit filel file2 

# Reads standard input and divides it into 3 parts 

# by appending any line containing at least one letter 

# to filel, appending any line containing digits but 

# no letters to file2, and by throwing the rest away. 
count=0 gone=0 

while read next 
do 

count="‘expr $count + l vM 
case M $next" in 
*[A-Za-z]*) 

echo "$next" >> $1 ;; 

*[0-9]*) 

echo "$next" >> $2 ;; 

*) 

gone= ,K expr $gone + T" 

esac 

done 

echo "$count lines read, $gone thrown away" 


Each iteration of the loop reads a line from the input and analyzes it. The 
loop terminates only when read encounters an end-of-file. Note the use of 
the exprcommand. 

Do not use the shell to read a line at a time unless you must-it can be an 
extremely slow process. 


LISTFIELDS 


grep $* | tr ":""\012" 


This procedure lists lines containing any desired entry that is given to it as 
an argument. It places any field that begins with a colon on a newline. 
Thus, if given the following input: 

joenewman: 13509 NE 78th St: Redmond, Wa 98062 
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list fields will produce this: 

joenewman 
13509 NE 78th St 
Redmond, Wa 98062 


Note the use of the tr command to transpose colons to linefeeds. 


MKFILES 


# Usage: mkfiles pref [quantity] 

# Makes "quantity" files, named prefl, pref2, ... 

# Default is 5 as determined on following line. 
quantity=${2-5} 

i=l 

while test "$i" -le "$quantity" 
do 

> $l$i 

i= ,K expr $i + T" 

done 


The mkfiles procedure uses output redirection to create zero -length files. 
The expr command is used for counting iterations of the while loop. 


NULL 


# Usage: null files 

# Create each of the named files as an empty file, 
for eachfile 

do 

>$eachfile 

done 
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This procedure uses the fact that output redirection creates the (empty) 
output file if a file does not already exist. 


PHONE 


# Usage: phone initials ... 

# Prints the phone numbers of the 

# people with the given initials. 


echo 'inits 

ext 

home' 

grep "$1" << END 

jfk 

1234 

999-2345 

lbj 

2234 

583-2245 

hst 

3342 

988-1010 

jqa 

4567 

555-1234 


END 


This procedure is an example of using an in-line input script to maintain a 
small database. 


TEXTFILE 


if test "$1" = "-s" 
then 

# Return condition code 
shift 

if test -z " v $0 $* v " # check return value 
then 

exit 1 

else 

exit 0 
fi 
fi 

if test $# -It 1 

then echo "$0: Usage: $0 [ -s ] file ..." 1>&2 
exit 0 
fi 

file $* | fgrep ' text' | sed ' s /: .*//' 
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To determine which files in a directory contain only textual information, 
textfile filters argument lists to other commands. For example, the follow- 
ing command line will print all the text files in the current directory: 

pr "textfile *" | Ipr 

This procedure also uses an -s flag which silently tests whether any of the 
files in the argument list is a text file. 


WRITEMAIL 


# Usage: writemail message user 

# If user is logged in, 

# writes message to terminal; 

# otherwise, mails it to user, 
echo "$1" | { write "$2" || mail ”$2" ;} 


This procedure illustrates the use of command grouping. The message 
specified by $1 is piped to both the write command and, if write fails, to the 
mail command. 
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4.15 Shell Grammar 


item : word 

input- output 
name = value 

simple- command: item 

simple- command item 

command : simple- command 
( command- list ) 

{ command- list } 

for name do command- list done 

for name in word do command- list done 

while command- list do command- list done 

until command- list do command- list done 

case word in case- part esac 

if command- list then command- list else- part fi 

pipeline : command 

pipeline | command 

andor: pipeline 

andor && I pipeline 
andor || pipeline 

command- list: andor 

command- list ; 
command- list & 
command- list ; andor 
command- list & andor 

input- output :> file 
< file 
<< word 
>> file 
digit > file 
digit < file 
digit >> file 

file: word 

& digit 

& - 
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case- part: pattern ) command- list ;; 

pattern: word 

pattern | word 

else- part: elif command- list then command- list else- part 

else command- list 
empty 


empty: 

word: a sequence of nonblank characters 

name: a sequence of letters , digits , or underscores 

starting with a letter 

digit: 0123456789 


Metacharacters 

and Reserved Words 

1. Syntactic 

I 

Pipe symbol 

&& 

And-if symbol 

ll 

Or-if symbol 

9 

Command separator 

99 

Case delimiter 

& 

Background commands 

( ) 

Command grouping 

< 

Input redirection 

< < 

Input from a here document 

> 

Output creation 

> > 

Output append 

# 

Comment to end of line 


2. Patterns 

* Match any character(s) including none 

? Match any single character 

[...] Match any of enclosed characters 
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3. Substitution 

${...} Substitute shell variable 

\.. v Substitute command output 


4. Quoting 

\ Quote next character as literal with no special meaning 

Quote enclosed characters excepting the back quota- 
tion marks (') 

Quote enclosed characters excepting: $'\" 


5. Reserved words 

if esac 

then for 

else while 
elif until 

fi do 

case done 

in {} 
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be: A Calculator 


5.1 Introduction 

be is a program that can be used as an arbitrary precision arithmetic calcu- 
lator. bc’s output is interpreted and executed by a collection of routines 
which can input, output, and do arithmetic on indefinitely large integers 
and on scaled fixed-point numbers. Although you can write substantial 
programs with be, it is often used as an interactive tool for performing 
calculator-like computations. The language supports a complete set of 
control structures and functions that can be defined and saved for later 
execution. The syntax of be has been deliberately selected to agree with 
the C language; those who are familiar with C will find few surprises. A 
small collection of library functions is also available, including sin, cos, 
arctan, log, exponential, and Bessel functions of integer order. 

Common uses for be are: 

- Computation with large integers. 

- Computations accurate to many decimal places. 

- Conversions of numbers from one base to another base. 

There is a scaling provision that permits the use of decimal point notation. 
Provision is made for input and output in bases other than decimal. 
Numbers can be converted from decimal to octal simply by setting the out- 
put base equal to 8. 

The actual limit on the number of digits that can be handled depends on 
the amount of storage available on the machine, so manipulation of 
numbers with many hundreds of digits is possible. 


5.2 Demonstration 

This demonstration is designed to show you: 

- Howto get into and out of be. 

- Howto perform simple computations. 

- How expressions are formed and evaluated . 

- Howto assign values to registers. 

A normal session with be begins by invoking the program with the com- 
mand: 

be 
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To exit be enter: 
quit 

or press Ctrl— d. Once you have entered be, you can use it very much like a 
normal calculator. As with the XENIX shell, commands are read as 
command-lines, so each line that you enter must be terminated by a 
RETURN. Throughout this chapter, the RETURN is implied at the end of 
each command line. Within be, normal processing of other keys, such as 
BACKSPACE and INTERRUPT, also works. 

For example, enter the simple integer 5: 

5 

Output is immediately echoed on the next line to the standard output, 
which is normally the terminal screen : 

5 

Here 5 is a simple numeric expression. However, if you enter the expres- 
sion : 


5*5.25 

(where the star (*) is the multiplication operator) a computation is exe- 
cuted and the result printed on the next line: 

26.25 

What has happened here is that the line 5 * 5. 25 has been evaluated, i.e., the 
expression has been reduced to its most elementary form, which is the 
number 26.25. The process of evaluation normally involves some type of 
computation such as multiplication, division, addition, or subtraction. 
For example, all four of these operations are involved in the following 
expression: 

(10*5)+50-(50/2) 

When this expression is evaluated, the subexpressions within parentheses 
are evaluated first, just as they would be with simple algebra, so that an 
intermediate step in the evaluation is “50+50-25” which ultimately reduces 
to the number “75”. 

The simple addition: 

10.45+5.5555555 
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produces the output: 

16.0055555 

Note how precision is retained in the above result. 
The two-part multiplication : 

(8*9)*7 

produces the answer: 

504 


The last part of this demonstration shows you how to store values in special 
alphabetic registers. For example, enter: 

a=100 ; b=5 

What happens here is that the registers a and b are assigned the values 100 
and 5, respectively. The semicolon is used here to place multiple be state- 
ments on a single line, just as it is used in the XENIX shell. This command 
line produces no output because assignment statements are not considered 
expressions. However, the registers a and b can now be used in expres- 
sions. Thus you can now enter: 

a*b; a+b 

to produce: 

500 

105 

To exit be, remember to enter: 
quit 

or press Ctrl- d. 

This ends the demonstration. Following sections describe use of be in 
more detail. The final section of this chapter is a be language reference. 
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5.3 Tasks 

This section describes how to perform common be tasks. Mastery of these 
tasks should turn you into a competent be user. 


5.3.1 Computing with Integers 

The simplest kind of statement is an arithmetic expression on a line by 
itself. For instance, if you enter: 

142857 + 285714 

and press RETURN, be responds immediately with the line: 

428571 

Other operators also can be used. The complete list includes: 

+ -*/%" 

They indicate addition, subtraction, multiplication, division, modulo 
(remaindering), and exponentiation, respectively. Division of integers 
produces an integer result truncated toward zero. Division by zero pro- 
duces an error message. 

Any term in an expression can be prefixed with a minus sign to indicate that 
it is to be negated (this is the “unary” minus sign). For example, the expres- 
sion: 


7+-3 

is interpreted to mean that -3 is to be added to 7. 

More complex expressions with several operators and with parentheses are 
interpreted just as in FORTRAN, with exponentiation ( ) performed first, 
then multiplication (*), division (/), modulo (%), and finally, addition (+), 
and subtraction (-). The contents of parentheses are evaluated before 
expressions outside the parentheses. All of the above operations are per- 
formed from left to right, except exponentiation, which is performed from 
right to left. 

Thus the following two expressions: 
a"b"c and a (b c) 

are equivalent, as are the two expressions: 
a*b*c and (a*b)*c 
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be shares with FORTRAN and C the convention that a/b*c is equivalent to 
(a/b)*c. 

Internal storage registers to hold numbers have single lowercase letter 
names. The value of an expression can be assigned to a register in the usual 
way, thus the statement: 

x = x + 3 

has the effect of increasing by 3 the value of the contents of the register 
named “x”. When, as in this case, the outermost operator is the assign- 
ment operator (=), then the assignment is performed but the result is not 
printed. There are 26 available named storage registers, one for each letter 
of the alphabet. 

There is also a built-in square root function whose result is truncated to an 
integer (see also Section 5. 5. 3.3, “Scaling”). For example, the lines: 

x=sqrt(191) 

x 

produce the printed result: 

13 


5.3.2 Specifying Input and Output Bases 

There are special internal quantities in be, called ibase and obase. ibase is 
initially set to 10, and determines the base used for interpreting numbers 
that are read by be. For example, the lines: 

ibase = 8 
11 

produce the output line: 

9 

and you are all set up to do octal to decimal conversions. However, beware 
of trying to change the input base back to decimal by entering: 

ibase = 10 

Because the number 10 is interpreted as octal, this statement has no effect. 
For those who deal in hexadecimal notation, the uppercase characters 
A-F are permitted in numbers (no matter what base is in effect) and are 
interpreted as digits having values 10-15, respectively. These characters 
must be uppercase and not lowercase. 
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The statement: 
ibase = A 

changes you back to decimal input base no matter what the current input 
base is. Negative and large positive input bases are permitted; however no 
mechanism has been provided for the input of arbitrary numbers in bases 
less than 1 and greater than 16. 

obase is used as the base for output numbers. The value of obase is initially 
set to a decimal 10. The lines: 

obase =16 
1000 

produce the output line : 

3E8 

This is interpreted as a three-digit hexadecimal number. Very large output 
bases are permitted. For example, large numbers can be output in groups 
of five digits by setting obase to 100000. Even strange output bases, such as 
negative bases, and 1 and 0, are handled correctly. 

Very large numbers are split across lines with seventy characters per line. 
A split line that continues on the next line ends with a backslash (\). 
Decimal output conversion is fast, but output of very large numbers (i.e., 
more than 100 digits) with other b ases is rather slow. 

Remember that ibase and obase do not affect the course of internal com- 
putation or the evaluation of expressions; they only affect input and output 
conversion. 


5.3.3 Scaling Quantities 

A special internal quantity called s cale is used to determine the scale of cal- 
culated quantities. Numbers can have up to 99 decimal digits after the 
decimal point. This fractional part is retained in further computations. 
We refer to the number of digits after the decimal point of a number as its 
“scale.” 

When two scaled numbers are combined by means of one of the arithmetic 
operations, the result has a scale determined by the following rules: 

Addition, subtraction 

The scale of the result is the larger of the scales of the 
two operands. There is never any truncation of the 
result. 
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Multiplication The scale of the result is never less than the max- 
imum of the two scales of the operands, never more 
than the sum of the scales of the operands, and sub- 
ject to those two restrictions, the scale of the result is 
set equal to the contents of the internal quantity, 
scale. 

Division The scale of a quotient is the contents of the internal 

quantity, scale. 

Modulo The scale of a remainder is the sum of the scales of 

the quotient and the divisor. 

Exponentiation The result of an exponentiation is scaled as if the 
implied multiplications were performed. An 
exponent must be an integer. 

Square Root The scale of a square root is set to the maximum of 
the scale of the argument and the contents of scale. 

All of the internal operations are actually carried out in terms of integers, 
with digits being discarded when necessary. In every case where digits are 
discarded truncation is performed without rounding. 

The contents of scale must be no greater than 99 and no less than 0. It is ini- 
tially set to 0. 

The internal quantities scale, ibase, and base can be used in expressions 
just like other variables. The line: 

scale = scale + 1 

increases the value of scale by one, and the line: 
scale 

causes the current value of scale to be printed. 

The value of scale retains its meaning as a number of decimal digits to be 
retained in internal computation even when ibase or obase are not equal to 
10. The internal computations (which are still conducted in decimal, 
regardless of the bases) are performed to the specified number of decimal 
digits, never hexadecimal or octal or any other kind of digits. 
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5.3.4 Using Functions 

The name of a function is a single lowercase letter. Function names are 
permitted to use the same letters as simple variable names. Twenty-six 
different defined functions are permitted in addition to the twenty-six vari- 
able names. 

The line: 

define a(x){ 

begins the definition of a function with one argument. This line must be 
followed by one or more statements, which make. up the body of the func- 
tion, ending with a right brace (}). Return of control from a function 
occurs when a return statement is executed or when the end of the function 
is reached. 

The return statement can take either of the two forms: 

return 
return (x) 

In the first case, the returned value of the function is 0; in the second, it is 
the value of the expression in parentheses. 

Variables used in functions can be declared as automatic by a statement of 
the form: 

autox,y,z 

There can be only one auto statement in a function and it must be the first 
statement in the definition. These automatic variables are allocated space 
and initialized to zero on entry to the function and thrown away on return. 
The values of any variables with the same names outside the function are 
not disturbed. Functions can be called recursively and the automatic vari- 
ables at each call level are protected. The parameters named in a function 
definition are treated in the same way as the automatic variables of that 
function, with the single exception that they are given a value on entry to 
the function. An example of a function definition follows: 

define a(x,y){ 
autoz 
z = x*y 
return (z) 

} 

The value of this function, when called, will be the product of its two argu- 
ments. 
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A function is called by the appearance of its name, followed by a string of 
arguments enclosed in parentheses and separated by commas. The result 
is unpredictable if the wrong number of arguments is used. 

If the function “a” is defined as shown above, then the line: 

a(7,3.14) 

would print the result: 

21.98 


Similarly, the line: 

x=a(a(3,4),5) 

would cause the value of “x” to become 60. 

Functions can require no arguments, but still perform some useful opera- 
tion or return a useful result. Such functions are defined and called using 
parentheses with nothing between them. For example: 

b0 

calls the function named b. 


5.3.5 Using Subscripted Variables 

A single lowercase letter variable name followed by an expression in brack- 
ets is called a subscripted variable and indicates an array element. The 
variable name is the name of the array and the expression in brackets is 
called the subscript. Only one-dimensional arrays are permitted in be. 
The names of arrays are permitted to collide with the names of simple vari- 
ables and function names. Any fractional part of a subscript is discarded 
before use. Subscripts must be greater than or equal to zero and less than 
or equal to 2047. 

Subscripted variables can be freely used in expressions, in function calls 
and in return statements. 

An array name can be used as an argument to a function, as in: 

f(a[ ]) 
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Array names can also be declared as automatic in a function definition with 
the use of empty brackets: 

define f(a[ ]) 
auto a[ ] 


When an array name is so used, the entire contents of the array are copied 
for the use of the function, then thrown away on exit from the function. 
Array names that refer to whole arrays cannot be used in any other context. 


5.3.6 Using Control Statements: if, while and for 

The if, while, and for statements are used to alter the flow within programs 
or to cause iteration. The range of each of these statements is a following 
statement or compound statement consisting of a collection of statements 
enclosed in braces. They are written as follows: 

if ( relation ) statement 
while ( relation) statement 

for ( expression! ; relation ; expression 2 )statement 


A relation in one of the control statements is an expression of the form : 
expression! rel-op expression 2 

where the two expressions are related by one of the six relational operators: 
<><=>= == != 


Note that a double equal sign (==) stands for “equal to” and an 
exclamation-equal sign (!=) stands for “not equal to”. The meaning of the 
remaining relational operators is their normal arithmetic and logical mean- 
ing. 

Beware of using a single equal sign (=) instead of the double equal sign (==) 
in a relational. Both of these symbols are legal, so you will not get a diagnos- 
tic message. However, the operation will not perform the intended com- 
parison. 

The if statement causes execution of its range if and only if the relation is 
true. Then control passes to the next statement in the sequence. 

The while statement causes repeated execution of its range as long as the 
relation is true. The relation is tested before each execution of its range and 
if the relation is false, control passes to the next statement beyond the 
range of the while statement. 
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The for statement begins by executing expression 1. Then the relation is 
tested and, if true, the statements in the range of the for statement are exe- 
cuted. Then expression! is executed. The relation is tested, and so on. The 
typical use of the for statement is for a controlled iteration, as in the state- 
ment: 


for(i=l; i<=10; i=i+l) i 
which will print the integers from 1 to 10. 

The following are some examples of the use of the control statements: 

define f(n){ 

auto i, x 
x=l 

for(i=l;i<=n;i=i-fl) x=x*i 
return (x) 


The line: 

f(a) 

prints “a” factorial if “a” is a positive integer. 

The following is the definition of a function that computes values of the 
binomial coefficient ( “m” and “n” are assumed to be positive integers): 

define b(n,m){ 
auto x, j 
x=l 

for(j=l ; j<=m; j=j+l) x=x*(n-j+l)/j 
return (x) 


5-11 



XENIX User’s Guide 


The following function computes values of the exponential function by 
summing the appropriate series without regard to possible truncation 
errors: 


scale = 20 
define e(x){ 

auto a, b, c, d, n 
a= 1 
b = l 
c = 1 
d = 0 
n = 1 

while(l==l) { 

a = a*x 
b =b*n 
c = c + a/b 
n = n + 1 

if(c==d) retum(c) 
d = c 

} 

} 


5.3.7 Using Other Language Features 

Some language features that every user should know about are listed 
below. 


- Normally, statements are entered one to a line. It is also permissible 
to enter several statements on a line if they are separated by semi- 
colons. 

-Kan assignment statement is placed in parentheses, it then has a 
value and can be used anywhere that an expression can. For exam- 
ple, the line: 

(x=y+ 17) 

not only makes the indicated assignment, but also prints the result- 
ing value. 

The following is an example of a use of the value of an assignment 
statement even when it is not placed in parentheses: 

x= a[i=i+l] 

This causes a value to be assigned to “x” and also increments i 
before it is used as a subscript. 
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The following constructions work in be in exactly the same manner 
as they do in the C language: 


Construction 

Equivalent 

WS&rU&££H%. 

E5S5HI 

X=+ V 

x = x+v 

x=-v 

x = x-v 

X=* V 

x = x*v 

X=/ V 

x = x/v 

X =% V 

x = x%v 

x=\ 

x = x\ 

X++ 

(^X+IVI 

x — 


++X 

x = x+l 

— X 

x = x-l 


Even if you don’t intend to use these constructions, if you enter one 
inadvertently, something legal but unexpected may happen. Be 
aware that in some of these constructions spaces are significant. 
There is a real difference between “x=-y” and “x= -y”. The first 
replaces “x” by “x-y” and the second by “-y”. 

The comment convention is identical to the C comment conven- 
tion. Comments begin with “/*” and end with 

There is a library of math functions that can be obtained by enter- 
ing: 


bc-1 

when you invoke be. This command loads the library functions 
sine, cosine, arctangent, natural logarithm, exponential, and Bessel 
functions of integer order. These are named “s”, “c”, “a”, “1”, 
“e”, and “j(n,x)”, respectively. This library sets scale to 20 by 
default. 

If you enter: 

be file ... 

be will read and execute the named file or files before accepting 
commands from the keyboard. In this way, you can load your own 
programs and function definitions. 
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5.4 Language Reference 

This section is a comprehensive reference to the be language. It contains a 
more concise description of the features mentioned in earlier sections. 


5.4.1 Tokens 

Tokens are keywords, identifiers, constants, operators, and separators. 
Token separators can be blanks, tabs or comments. Newline characters or 
semicolons separate statements. 

Comments Comments are introduced by the characters “/*” and 
are terminated by 

Identifiers There are three kinds of identifiers: ordinary 
identifiers, array identifiers and function identifiers. 
All three types consist of single lowercase letters. 
Array identifiers are followed by square brackets, 
enclosing an optional expression describing a sub- 
script. Arrays are singly dimensioned and can contain 
up to 2048 elements. Indexing begins at 0 so an array 
can be indexed from 0 to 2047. Subscripts are trun- 
cated to integers. Function identifiers are followed by 
parentheses, enclosing optional arguments. The 
three types of identifiers do not conflict; a program 
can have a variable named “x”, an array named “x”, 
and a function named “x”, all of which are separate 
and distinct. 

Keywords The following are reserved keywords : 

ibase if 
obase break 
scale define 
sqrt auto 
length return 
while quit 


Constants Constants are arbitrarily long numbers with an 
optional decimal point. The hexadecimal digits A-F 
are also recognized as digits with decimal values 
10-15, respectively. 


5-14 



be: A Calculator 


5.4.2 Expressions 

All expressions can be evaluated to a value. The value of an expression is 
always printed unless the main operator is an assignment. The precedence 
of expressions (i.e., the order in which they are evaluated) is as follows: 

Function calls 

Unary operators 

Multiplicative operators 

Additive operators 

Assignment operators 

Relational operators 
There are several types of expressions: 

Named expressions 

Named expressions are places where values are stored. Simply 
stated, named expressions are legal on the left side of an assign- 
ment. The value of a named expression is the value stored in the 
place named. 

identifiers 

Simple identifiers are named expressions. They have an 
initial value of zero . 


array- name [ expression ] 

Array elements are named expressions. They have an 
initial value of zero. 

scale , ibase and obase 

The internal registers scale, ibase, and obase are all 
named expressions. Scale is the number of digits after 
the decimal point to be retained in arithmetic operations 
and has an initial value of zero. Ibase and obase are the 
input and output number radixes respectively. Both 
ibase and obase have initial values of 10. 


Constants 

Constants are primitive expressions that evaluate to themselves. 
Parenthetic Expressions 

An expression surrounded by parentheses is a primitive expression. The 
parentheses are used to alter normal operator precedence. 
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Function Calls 

Function calls are expressions that return values. They are discussed in 
section 5.4.3. 


5.4.3 Function Calls 

A function call consists of a function name followed by parentheses con- 
taining a comma-separated list of expressions, which are the function 
arguments. The syntax is as follows: 

function - name ( [ expression [ , expression ...]]) 


A whole array passed as an argument is specified by the array name fol- 
lowed by empty square brackets. All function arguments are passed by 
value. As a result, changes made to the formal parameters have no effect 
on the actual arguments. If the function terminates by executing a return 
statement, the value of the function is the value of the expression in the 
parentheses of the return statement, or 0 if no expression is provided or if 
there is no return statement. Three built-in functions are listed below: 


sqrt ( expr ) The result is the square root of the expression and is 
truncated in the least significant decimal place. The 
scale of the result is the scale of the expression or the 
value of scale , whichever is larger. 


length {expr) The result is the total number of significant decimal 
digits in the expression. The scale of the result is zero. 

scale ( expr ) The result is the scale of the expression. The scale of 
the result is zero. 


5.4.4 Unary Operators 

The unary operators bind right to left. 

— expr The result is the n egative of the expression . 

+ + named_expr The named expression is incremented by one. The 
result is the value of the named expression after incre- 
menting. 

named_expr The named expression is decremented by one. The 

result is the value of the named expression after decre- 
menting. 
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named_expr ++ The named expression is incremented by one. The 
result is the value of the named expression before 
incrementing. 

named_expr — The named expression is decremented by one. The 
result is the value of the named expression before 
decrementing. 


5.4.5 Multiplicative Operators 

The multiplicative operators (*, /, and %) bind from left to right. 

expr* expr The result is the product of the two expressions. If 

“a ” and “b” are the scales of the two expressions, 
then the scale of the result is: 

min ( a+b, max ( scale, a, b ) ) 

expr/expr The result is the quotient of the two expressions. The 

scale of the result is the value of scale. 

expr% expr The modulo operator (% ) produces the remainder of 
the division of the two expressions. More precisely, 
a°/ob is a-a/b*b. The scale of the result is the sum of 
the scale of the divisor and the value of scale. 

expr expr The exponentiation operator binds right to left. The 

result is the first expression raised to the power of the 
second expression. The second expression must be 
an integer. If “a” is the scale of the left expression and 
“b” is the absolute value of the right expression, then 
the scale of the result is: 

min ( a*b, max ( scale, a ) ) 

5.4.6 Additive Operators 

The additive operators bind left to right. 

expr+expr The result is the sum of the two expressions. The 
scale of the result is the maximum of the scales of the 
expressions. 

expr— expr The result is the difference of the two expressions. 

The scale of the result is the maximum of the scales of 
the expressions. 
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5.4.7 Assignment Operators 

The assignment operators listed below assign values to the named expres- 
sion on the left side. 

named _expr = expr 

This expression results in assigning the value of the expres- 
sion on the right to the named expression on the left. 

named _expr = +expr 

The result of this expression is equivalent to 
named _expr = named _expr + expr . 

named _expr = — expr 

The result of this expression is equivalent to 

named _expr — na med_expr — expr . 

named_expr=*expr 

The result of this expression is equivalent to 

named _expr = named_expr*expr. 

named _expr = I expr 

The result of this expression is equivalent to 

named_expr— named _expr! expr. 

named _expr = % expr 

The result of this expression is equivalent to 

named_expr=named_£xpr%expr. 

named _expr -"expr 

The result of this expression is equivalent to 

named _expr = named _expr expr . 


5.4.8 Relational Operators 

Unlike all other operators, the relational operators are only valid as the 
object of an if or while statement, or inside a for statement. 

These operators are listed below: 

expr < expr 

expr> expr 

expr <= expr 

expr> —expr 
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expr= -expr 
expr!=expr 


5.4.9 Storage Classes 

There are only two storage classes in be: global and automatic (local). Only 
identifiers that are to be local to a function need to be declared with the 
auto command. The arguments to a function are local to the function. All 
other identifiers are assumed to be global and available to all functions. 

All identifiers, global and local, have initial values of zero. Identifiers 
declared as auto are allocated on entry to the function and released on 
returning from the function. They, therefore, do not retain values between 
function calls. Note that auto arrays are specified by the array namer, fol- 
lowed by empty square brackets. 

Automatic variables in be do not work the same way as in C. On entry to a 
function, the old values of the names that appear as parameters and as 
automatic variables are pushed onto a stack. Until return is made from the 
function, reference to these names refers only to the new values. 


5.4.10 Statements 

Statements must be separated by a semicolon or a newline. Except where 
altered by control statements, execution is sequential. There are four types 
of statements: expression statements, compound statements, quoted 
string statements, and built-in statements. Each kind of statement is dis- 
cussed below: 

Expression statements 

When a statement is an expression, unless the main 
operator is an assignment, the value of the expression 
is printed, followed by a newline character. 


Compound statements 

Statements can be grouped together and used when 
one statement is expected by surrounding them with 
curly braces ( { and } ). 

Quoted string statements 

For example: 


string 


prints the string inside the quotation marks. 
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Built-in statements 

Built-in statements include auto, break, define, for, 
if, quit, return, and while. 

The syntax for each built-in statement is given below: 
Auto statement 

The auto statement causes the values of the identifiers 
to be pushed down. The identifiers can be ordinary 
identifiers or array identifiers. Array identifiers are 
specified by following the array name by empty square 
brackets. The auto statement must be the first state- 
ment in a function definition. Syntax of the auto state- 
ment is: 

auto identifier [, identifier ] 

Break statement 

The break statement causes termination of a for or 
while statement. Syntax for the break statement is: 

break 

Define statement 

The define statement defines a function; parameters 
to the function can be ordinary identifiers or array 
names. Array names must be followed by empty 
square brackets. The syntax of the define statement 
is: 


define ([ parameter [ , parameter . . .^{statements} 
For statement 

The for statement is the same as: 

first- expression 
while {relation ) { 
statement 
last - expression 


All three expressions must be present. Syntax of the 
for statement is: 

for {expression) relation; expression) statement 
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If statement 

The statement is executed if the relation is true. The 
syntax is as follows: 

if {relation) statement 

Quit statement 

The quit statement stops execution of a be program 
and returns control to XENIX when it is first encoun- 
tered. Because it is not treated as an executable state- 
ment, it cannot be used in a function definition or in 
an if, for, or while statement. Note that entering a 
Ctrl- d at the keyboard is the same as entering “quit”. 
The syntax of the quit statement is as follows: 

quit 

Return statement 

The return statement terminates a function, pops its 
auto variables off the stack, and specifies the result of 
the function. The result of the function is the result of 
the expression in parentheses. The first form is 
equivalent to “retum(O)”. The syntax of the return 
statement is as follows: 

return (expr) 

While statement 

The statement is executed while the relation is true. 
The test occurs before each execution of the state- 
ment. The syntax of the while statement is as follows: 

while {relation) statement 
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6.1 Introduction 

This chapter explains how to build a communication system for your com- 
puter using either a direct serial line or a normal telephone line and a 
Hayes Smartmodem 1200. A communication system provides a way to : 

e Log in to the computer from a remote terminal or computer. 

© Use the cu(C) command to call and log in to other computers. 

• Use the uucp(C) command to copy files to and from remote com- 
puters. 

• Use the uux(C) command to execute remote commands, including 
the mail(C) program (rmail) on a remote computer. 

Li particular, the communication system is a practical solution to the prob- 
lem of two micnet networks (see the XENIX Operations Guide) that cannot 
be connected because of distance or cost of cable. 

All communication tasks are supported by a variety of files and directories. 
In addition, the tasks invoked by the uucp and uux commands are actually 
performed by a system of underlying programs, called the uucp system. 
The files and underlying programs are described in full later in this chapter. 

The following sections explain how to install a modem, and how to 
configure the necessary files for your system . They also explain how to and 
maintain a uucp system, and describe the details of how it works. 


6.1.1 HowTo Use This Guide 

This guide describes how to build a uucp system and covers both hardware 
installation, and software configuration. Topics are first presented in a 
general form, then in greater detail. 

Each control file is first described in general form. Then, you are shown 
how to configure the file with the uuins tali utility. 

You do not need to use uuins tall to set up your communication system. 
However, this utility helps you to be more accurate when you configure the 
system. 

Be sure to read the text carefully, since there are many similar commands 
and actions. 
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6.2 What You Need 

To install a direct wire communication system on your computer, you need 

• At least one RS-232 serial line (or serial port) on your computer to 
use for uucp and cu . 

© The uucp programs and files extracted from your XENIX System 
distribution. 

If you want to use your computer as a dial-in and/or dial-out site with a 
modem, you also need: 

© A modem. The default supported modem is a Hayes Smartmodem 
1200, but you can modify the supplied dialing routines for other 
modems. 

© A standard telephone jack for access to the telephone system 
(touch tone line required for the Hayes). 

© An RS -232 cable to connect the serial line to the modem. 


Finally, since many of the tasks you must perform require special permis- 
sions, you must log in to your computer’s super-user account before per- 
forming them. Check with your computer’s system manager before 
proceeding with this installation, or turn to the XENIX Operations Guide 
for instructions on how to log in as the super-user. 


6.3 Installing A Direct Wire 

This section describes how to install a direct wire between two computers. 
To connect two computers with a direct wire, you need to : 

© Choose a serial line on each machine. 

© Connect a serial wire (RS -232) between the two machines, using the 
chosen serial lines. 

® Decide which machine is the dial-in site and which is the dial-out 
site. The dial-out site calls up and logs in to the dial-in site. 

When you finish with these steps, you can proceed with next sections to 
actually set up the sites. 
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6.3.1 Choose a Serial Line 

On each machine, you must choose the RS-232 serial line you want to use. 
If there are no lines available, you must install a new serial line or make one 
available by removing any device connected to it. If you remove a terminal, 
make sure no one is logged in. 

Once you have chosen a serial lines, find the name of the device special file 
associated with the line by looking in Appendix A of the XENIX Opera- 
tions Guide. The filename should have the form 

/dev/ttyAm 

where nn is the number of the corresponding line. For example, /dev /tty la 
usually corresponds to serial line 0. You need the name of the actual line 
for later steps. 

The serial line you use for your communication system should be owned by 
uucp . To make sure the line is owned by uucp enter this commands 

chown uucp /dzv/ttynn 

where nn is the number of the corresponding line. 


6.3.2 Connect a Serial Wire 

You connect two computers together using an RS-232 cable. The actual 
pin configurations sometimes vary between machines. 

Typically, the wire should connect pins 2, 3, and 7 (and/or 20) on one com- 
puter to the same pins on the second computer. Sometimes the cable must 
be nulled , which means that pin 2 on one machine is connected to pin 3 on 
the other, and vice versa. 

Since the connections can vary, you should check the hardware manuals 
for each computer to determine the proper pin connections. 


Testing A Connection 

For this section, tty 2a is used as the example serial line for both machines. 

To test the wire connection between two machines, follow these steps: 

1. Disable the serial lines on each machine. On each computer, enter 
the command: 

disable /dev/tty2a 
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2. Attach one end to one of the serial wire to one of the machines. 
Attach the other end to the standard data port of a terminal. 

3. Enter this command at the computer: 

(stty 9600; date ) < /dev/tty2a > /dev/tty2a 

tty2a is our example serial line, and the date command provides 
sample output. 

You should see the output of the date command appear on the ter- 
minal screen. Repeat this procedure on the other machine. 

If this doesn’t work , check the following: 

- The wire is plugged in properly at each end. 

- The continuity of the wire. 

- The terminal is configured correctly 
(baud rate, parity, etc.). 

- The serial line is disabled . 

- You are using the correct pin numbers. 


Note 

An unterminated serial line can cause serious system problems. Do 
not leave serial lines dangling. 


6.4 Installing the Modem 

With a modem, you can communicate with computers over standard 
phone lines. These are the steps to install a modem: 

• Choose a serial line. 

• Set the dialing configuration. 

• Connect the modem. 

• Test the connection. 

The following sections explain each step in detail. Make sure you inform 
the telephone company of your intent to use a modem with your telephone 
line. 
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You should be particularly careful, since certain telephone services (such 
as “call waiting”) can disrupt uucp conversations. 


6.4.1 Choose a Serial Line 

Choose the RS-232 serial line you want to use with the system and connect 
to the modem. If there are no lines available, you must install a new serial 
line or make one available by removing any device connected to it. If you 
remove a terminal, make sure no one is logged in . 

Once you have chosen a serial line, find the name of the device special file 
associated with the line by looking in Appendix A of the XENIX Opera- 
tions Guide. The filename should have the form 

fdev/tlynn 

where nn is the number of the corresponding line. For example, /dev/ttyOO 
usually corresponds to serial line 0. You need the name of the actual line 
for later steps. 

The serial line you use for your communication system should be owned by 
uucp. To make sure the fine is owned by uucp enter this command: 

chown uucp /dev/tty nn 

where nn is the number of the corresponding line. 


6.4.2 Set the Dialing Configuration 

In this communication system, your modem can be used to both send and 
receive calls. You must set the appropriate switches on the modem. Fol- 
low these steps to configure a Hayes Smartmodem : 

1. Remove the front cover of the modem and locate the 8-pin 
configuration switch. (See the Hayes Reference Manual for instruc- 
tions on how to remove the cover and locate the switch . ) 

2. Set the pins on the configuration switch to the following positions: 


1 1 2 3 4 5 6 7 sl 

up 

• 

• 


• 

• 

• 

• 


down 



• 





© 


3 . Replace the front cover. 

If you have a different modem, consult your reference manual for the 
proper switch settings to both send and receive calls. 
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6.4.3 Connect the Modem 

Once your modem’s dialing configuration is set, you are ready to connect 
the modem to your computer. For proper modem operation, the RS-232 
cable must provide the pin connections shown below. 

Note that the computer’s serial connector must have a DTE (Data 
Terminal Equipment) configuration. The modem is assumed to have a 
DCE (Data Communications Equipment) configuration. 

Pin Connections 


Computer 

(DTE) 

Modem 

(DCE) 

1 

1 

2 

2 

3 

3 

6 

6 

7 

7 

8 

8 

20 

20 


These pin connections are explained in the Hayes Smartmodem 1200 
Reference Manual. 

Review the installation instructions given in the Hayes Reference Manual, 
then follow these steps: 

1. Connect the RS-232 serial cable to the serial line connector on the 
modem, then to the serial line connector on your computer. Make 
sure the cable is fully connected. 

2. Plug the telephone line cable into the telephone connector on the 
modem, then into the telephone wall jack. 

3. Plug in the power cord of the modem. 


6.4.4 Test the Modem 

As the last step of the modem installation, you should test the modem to 
make sure that it can send and receive calls. Once you have verified that 
the modem is working, you can begin to use the communication system. 

To test the modem, follow these steps: 

1. Start the computer and log in as the super-user. 
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2. Disable the modem serial line by entering 

disable /dev/tty nn 

where nn is the “tty” number of the serial line. 

3. Turn on power to the modem. 

4. Make sure the volume switch on the modem is at an appropriate 
level. You must be able to hear the modem to carry out this test suc- 
cessfully. See the Hayes Reference Manual for the location of this 
switch. 

5. Invoke the dial(C) program using a command line of the form 

/usr/lib/uucp/ dial /dev/tty/w number speed 

where /dcv/ttynn is the filename of your serial line, and number is 
your telephone number (the number of the telephone jack your 
modem is connected to). For example, if your serial line is 
Idevl tty la and the number is “5551234, ” enter: 

/usr/lib/uucp/dial /dev/ttyla 5551234 1200 

6. Listen carefully to the modem. You should hear each digit as the 
number is dialed, then hear the busy signal when the telephone sys- 
tem tries to make connection with your modem. 

7. If the busy signal is present, wait a few moments and listen carefully 
for the modem to hang up. The modem automatically discontinues 
any call for which it cannot make a connection. 

8. If the busy signal is not present, make sure you have connected the 
modem to the telephone jack. Make sure the jack is connected to 
the phone system. Make sure you gave the correct number when 
invoking dial. 

9. If you did not hear the modem dial, make sure the volume switch is 
up. Make sure the modem is connected to the correct serial line and 
that the cable connection is tight. Make sure you gave the correct 
filename when invoking dial. Make sure modem's power is on. 


6.5 Installing a uucp System 

When you install the uucp system, you configure a series of files which con- 
tain information about, and control the actions of the uucp programs. 
You can modify these files with a standard text editor, or you can use the 
uuins tall utility. 
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To install a uucp system you: 

• Set up the proper hardware (direct wire or modem). 

• Choose a system name for your computer (systemid). 

• Create either a dial-in or dial-out site, or a combination of both. 

• Create a transmission schedule to ensure that communications 
operate automatically. 

Note that when you install the uucp system, or make any modifications, 
you should be logged in as root. Virtually all of the uucp files are writable 
only by the super-user, and many of them are also readable and executable 
only by root. 

There are two ways to configure a uucp site: 

• Asa dial - in site. 

• As a dial- out site. 


As a dial-in site, other computers call up and log in to your system. They 
can transfer files and execute certain commands. 

As a dial-out site, your computer calls up other computers and logs in. 
Your computer initiates file transfers to and from the remote machine, as 
well as local and remote command execution. 


Note 

The terms dial-in , dial- out and call describe the communication 
process for b oth direct wire and modem/ telephone sites. 


You can configure your system as both a dial-in and dial-out site, although 
it cannot function as both at exactly the same time. This is because the 
serial line is enabled at a dial-in site, and disabled at a dial-out site. (The 
enable(C) and disable(C) commands are discussed in the following sec- 
tions, and in the XENIX Reference.) 

You can change from a dial-in to a dial-out site at specific times by placing 
the appropriate commands to enable and disable the serial line in a shell 
script that is executed by the cron(C) program. 
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The following sections explain how to use the uuins tall utility to create files 
for both kinds of sites. They also explain how to create a transmission 
schedule using cron and how to link together micnet sites. 

6.5.1 uuinstall 

uuins tall helps you install information in various uucp control files. To use 
the uuins tall utility, log in as root. 

Then, enter: 

# uuinstall 

The screen displays the main menu: 

UUCP Administration Utility 
Choose one of the following options: 

1. Examine or update system identification. 

2. Examine or update dial-in or dial-out devices. 

3. Examine or update dialing code abbreviations. 

4. Examine or update system connections. 

5. Examine or update UUCP users. 

6. Terminate this program. 

Choose an option: 

uuinstall returns to this display after performing the action you request. 
You also return to this main menu if you only press RETURN at a menu 
option without entering any data. 
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Each menu option acts on a particular control file: 

Option Control File Function 


1 . 


3 . 


4 . 


5 . 


/etc/systemid 


/ usr/lib/uucp/L-devices 


/ usr/lib/ uucp/L-dialcodes 


/usr/lib/uucp/L.sys 


/ usr/lib / uucp/U S ERFILE 


Contains the uucp name 
of your computer. Other 
computers on the uucp 
network know your com- 
puter by this name. 

Describes the devices on 
your computer which are 
connected to other com- 
puters on the uucp net- 
work. 

Contains a list of abbrevi- 
ations used in the dialing 
codes for placing calls to 
other computers. 

Lists the systems on the 
uucp network you can 
call, or which call you. It 
also specifies when you 
can call, or are called, 
which serial lines are used 
and the baud rate used. 

Defines which directories 
a given site (or a given 
user) may access using the 
uucp and uux commands. 


There is an additional file that you cannot change with the uuins tall utility: 

/usr/lib/uucp/L.cmds Contains a list of all commands which the 

uucp programs are allowed to execute. 
This list overrides the default allowable 
commands. The file can be changed with 
any standard text editor. 

When you have made all necessary changes to the uucp control files, enter 
option ‘6’ to exit from the program . The uuins tall utility then displays : 

Do you want to update the UUCP control files? 

If you enter ‘y\ the control files are updated. Any other response causes 
the uuinstall utility to exit without making any changes to the files. Each of 
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the options in the main uuinstall menu are described in detail later in this 
chapter. 

You can also invoke the uuinstall program with a - r command line option. 
This allows you to read the current settings of the uuinstall menu options, 
but will not allow you to make any changes when you exit the program. 

You must be the super-user to run uuinstall. Refer to uuinstall(C) in the 
XENIX Reference for more information. 


6.5.2 Choosing a uucp Site Name 

In a uucp system, every computer belongs to a “site.” A site is any com- 
puter or any micnet network that can communicate with the uucp system. 

To distinguish one site from another, every site must have a unique “site 
name.” A site name is any combination of letters and digits that begins with 
a letter and is no more than seven characters long. The site name may then 
be used in uucp and uux commands to direct transmissions to the 
appropriate computer or micnet network. 

The site name should suggest some characteristic of the site, such as its 
location or affiliation. For example, a site in Chicago can be named “Chi- 
cago,” or a site in the legal department can be named “legal.” The site 
name must be unique. That is, no other computer that calls your computer 
or is called by your computer can have the same site name. 

Once you chose a site name, add it to the /etc/systemid file as described in 
the next section. 


Creating the systemid File 

Each site must have a /etc/systemid file. The file defines the site name of 
the given site and associates the site with a micnet network, if any. The file 
has the form: 

site name 
[ machinename ] 


sitename The name of the given site 

machinename The micnet machine name for that computer. If the 
system is not connected to a micnet network, the 
machinename is optional. 
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For example, this entry defines a site named “Chicago” whose micnet 
machine name is “brewster”: 

Chicago 

brewster 


To set up the systemid file for your system, enter: 

# uuinstall 

At the main menu, choose option ‘1.’ The current site name and machine 
name is displayed and you are prompted for any changes to either of these 
names. If you want to make any changes, you are prompted to enter them. 

Since uucp systems are often created after a micnet network has been esta- 
blished, the systemid file usually already exists on a given site. In this case, 
you must add the site name to the beginning of each systemid file on each 
computer m the micnet network . 


Note that you may list more than one machine name if desired, but each 
name must be on a separate line. For a full description of the systemid file 
see sys temid (M) in the XENIX Reference Manual. 


6.5.3 Creating a Dial- In Site 

To create a dial-in site for logins by remote terminals or computers, you: 

• Choose a serial line. 

• Disable the serial line. 

• Edit the serial line entry in the I etc I ttys file. 

Then you place information into several control files to allow logging in on 
the serial line you have chosen : 

• Usemkuser(C)to add a login entry for uusite. 

• Add user access information to the USERFILE file. 

• Set access permissions in the L.cmds file. Any permissions listed in 
this file override the uucp default permissions. 

• Use uuinstall to add uusite information to L.sys. 

• Enable the serial line. 
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Choose a Serial Line 

Use a line with modem control for the dial-in line. Refer to Section 6.4.1 
for more information on choosing a serial line. 


Disable the Serial Line 

Disabling the serial line is the next step in creating a dial-in line. To disable 
the serial line, follow these steps: 

1 . If you are using a modem , make sure it is installed and tested . 

2. Make sure you are logged in as the super-user. 

3. Disable the serial line by entering: 

# disable /dev/tty«« 

where nn is the number of your serial line. If the line is already dis- 
abled, the command displays an error message that you can safely 
ignore. 


Edit /etc/ttys 

The file /etc/ttys contains a list of possible login terminals. Enter the com- 
mand: 


# cat /etc/ttys 

You see a series of entries for the different serial lines. 

The form of an entry is: 
xxttynn 

Where: 

xx Two digits. The first is either a one (1), which means the line is 
enabled, or a zero (0), which means the line is disabled. The 
second is a number or letter which defines the baud rate of the 
line. 

nn The number of the tty. 
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An example entry for a serial line connected to a modem might be: 

03tty2a 

The first digit is a zero, which means the line is disabled, so that terminals 
or computers cannot log in on that line. That digit changes to a one when 
you use the enable command (the next step). 

The second digit, ‘3,’ means that the getty running on that line cycles the 
baud rate of that line between 1200 and 300 baud. 

For a direct line, the entry might be: 

06tty2A 

If you need to change an entry, do so with a standard text editor. For more 
information on I etc! ttys, and the various control codes, see getty(M) in the 
XENIX Reference . 


Create uucp Login Entries 

A dial-in site must provide a login entry for the sites that call it. These 
entries are placed in the /etc/passwd file. 

A uucp login entry has the same form as an ordinary user login entry (see 
Chapter 3 in the XENIX Operations Guide), but has a special login direc- 
tory and login program instead of the normal user directory and shell. 

To create a uucp login entry, use the mkuser(C) program and follow these 
steps: 

1. Choose a new login name and a user ID for the uucp login. The 
name may be any combination of letters and digits that is no more 
than eight characters long. The user ID must be an integer number 
in the range 200 to 65535. 

Make sure the name and ID are unique. A uucp login entry must not 
have the same name or ID as any other login entry. 

2. Enter: 

# /etc/mkuser 

Follow the program menus and prompts to add the user(s) you wish. 
For a shell type, use “uucp Login.” 

3. mkuser prompts you to enter a password for the new user. This is 
optional for uucp logins. 
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You can either create new login entries for each site that calls your site, or 
use one entry for all sites. 


Note 

A site that dials in to your computer must know if its login has a pass- 
word. Each site also needs to know what its password is, otherwise it 
cannot log in to your system. 


SetUp theUSERFILE 

The USERFILE file defines which directories a given site (or a given user) 
may access using the uucp and uux commands. You should create one 
USERFILE entry for each site or user with a login entry in the /etc/passwd 
file. Each entry has the form 

login, sitenamefC] pathname... 


login 

sitename 

c 

pathname 


The login name for a given site (optional). 

The site name of a given site (optional). 

The c option indicates a callback should occur. 

One or more full pathnames of the directory(s) the 
given site may access. 


The following rules explain how access is granted for each entry. 

1. A calling site is granted access to those directories defined in an 
entry containing its site name. 

2. A calling site whose name does not appear in an entry is granted 
access to the directories defined for the first entry without a site 
name. 

3. A user is granted access to those directories defined in an entry con- 
taining his login name. 

4. A user whose login name does not appear in an entry is granted 
access to directories defined in the first entry without a login name. 
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You may have more than one entry with the same login name if you want. 
However, you must make sure that at least one of these entries also has the 
site name of any calling site which can log in with that name, or that one of 
these entries has no site name. 

For example, consider the following entries. 

uuccg, Chicago /usr 
uuccg, Chicago /usr2/market 
uucp, /usr/vendor 
schmidt, /usr2/market 
schmidt, /usr/vendor 
, /usr/spool/uucp/uucppublic 

The site named Chicago” has access to files in the directories named 
“/usr” and u /usr2/market”. Any other site will be granted access to 
“/usr/vendor” only. A local user named “schmidt” is granted access to the 
directories “/usr2/market” and “/usr/vendor”. All other users have 
access to “/usr/spool/uucp/uucppublic” only. 

You can enter this information by choosing option ‘5’ of the uuins tall pro- 
gram. 

You are prompted as to whether you want to see the current entries in the 
userfile. If you enter c y, 5 you see a screen display similar to the following: 

# Login Sitename Paths 

0. ANYLOGIN ANYSITE 

1- uucg Chicago 

The ANYLOGIN and ANYSITE entries are special entries displayed when- 
ever a blank login name or site field are encountered in the userfile. 

You are then asked whether you want to add or delete an entry in the file. 
Entries are always deleted by specifying the entry number (#) shown in the 
first column of the screen display. If you request that an entry be added, 
you are prompted for the login name, site name and path names of the new 
entry. If you press RETURN in response to this prompt, the display returns 
to the main uuinstall menu. 

In response to the requests for a login name and site name, you may enter 
the special name “A” (meaning “ANY”) which corresponds to a blank 
field in the userfile for the login or site names. The prompts for pathnames 
continue until you enter a blank line. 
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Create the L.cmds File 

You do not need to create the file L.cmds unless you have special security 
considerations. The uucp login shell may execute only the following 
default commands: 


• lpr • mail 

• rmail • rnews 

• who 


If you place a list of commands in the file L.cmds , that list supersedes the 
default allowable commands. If the L.cmds file exists, but is empty, no 
commands are allowed. 


Create the L.sys File 

The /usr/lib/ uucp I L.sys file defines the names, telephone numbers, and 
login information of all sites in the system. (Note that tabs should not be 
used as field separators.) The file contains one or more entries of the form 

sitename time device speed phone login 


With: 


sitename 

The name of the site to be called, 

time 

A combination of letters and digits that gives the 
weekdays and times when the given site can be called, 

device 

The name of the device through which the given site is 
to be called, 

speed 

The line speed for the call, 

phone 

The phone number of the given site, and 

login 

Login information required to log in to the given site. 


The time defines when the given site can make calls to other sites. It has the 
form 


days times 

where days is a list of one or more days of the week, and times is a range of 
times of day. The days of the week may be “Su”, “Mo”, “Tu”, “We”, 
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“Th”, “Fr”, “Sa 55 , “Wk”, “Any”, and “Never”. “Wk” means “any week- 
day,” “Any” stands for “any time, 5 and “Never 55 indicates that the site is 
never called (except by special request). 

The time of day must be given as a four-digit number. The first pair of 
digits gives the hour (in terms of a 24 hour clock), the second pair gives the 
minutes. A range of times is a pair of times of the day separated by a 
hyphen (-). For example, the entry 

MoT uThOSOO- 1230 

allows the given site to be called any Monday, Tuesday, or Thursday from 8 
in the morning to 12:30 in the afternoon. 

The device must be the keyword “ACU 55 if you are using a modem. If you 
are using a direct line to the other site, then you must give the filename of 
the serial line (or other device) you intend to use (for example, ttyla). 

The phone must be the telephone number of the given site. It must have the 
correct number of digits (including area code if necessary) or be a combi- 
nation of L- dialcodes abbreviations and digits. L-dialcode abbreviations 
must go before any digits. Do not use hyphens. For example, “5551234” is 
a valid local number and “2065551234” is a valid long distance number. If 
the abbreviation “sc” is defined to be “555, 55 then “sc 55 may be used in 
place of “5551234.” 

With the Hayes modem, you may use a comma (,) in a number to cause a 
delay when dialing. This is useful if you must dial for an outside line before 
placing the call. 

For example, the number “9,5551234” causes a delay immediately after the 
“9 55 is dialed. After the delay, the rest of the number is dialed. If you are not 
using a modem, then phone must be the filename of the device you intend 
to use instead of a phone number. 

The login must be a sequence of names, numbers, and other information 
that represents the steps required to log in to the given site. This sequence 
has the form 

expect send [ expect send ]... 

where expect is the prompt or message that you expect the given site to 
return to the calling site, and send is the name, number, or other informa- 
tion that you want to send in response to the expected prompt or message. 

For example, the following is the login sequence for a typical XENIX site 

ogin: uuccg ssword: market 
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Note that “ssword:” is given instead of the complete prompt “Password:”. 
Only the last eight characters in each expected prompt or message are 
examined, so you do not need to give the preceding characters if you want 
to save space. 

If you anticipate problems during the login sequence, you may include a 
conditional response immediately after each expected prompt or message. 
This conditional response has the form 

expect [ -send-expectl ] ... 

where expect is the prompt or message you expect the given site to return, 
send is the name or number you want to send if the prompt or message 
returned is not correct, and expectl is the prompt or message you expect 
after sending the conditional response. For example, the following shows 
how to invoke the “login” prompt if it is not immediately present. 

— ogin-EOT-ogin-uuccg ssword: market 

There are two special keywords that you may use in the login sequence. 
The “EOT” keyword causes an end of transmission character to be sent 
and the “BREAK” keyword causes a break character to be sent. (The 
break character is simulated using line speed changes and null characters 
and may not work on all devices and/or systems.) 

The complete L.sys entry is one line, as shown by the following example: 

Chicago Any ACU 1200 5551234 ogin: uucp ssword: market 

Set up the L.sys file by choosing option ‘4’ of the uuinstall command. You 
are prompted as to whether you want to see the current entries in the L.sys 
file. 


If you enter ‘y, ’ you see a screen display similar to the following: 


Entry#: 

System name: 
Time to call: 
Line: 

Speed: 

Phone#: 

Login sequence: 


0 

Chicago 

Any 

ACU 

1200 

5551234 

ogin: uucp ssword: market 


Press Enter to see next entry 


A new entry is displayed each time you press the RETURN key. You are 
then asked whether you want to add or delete an entry in the file. Entries 
are always deleted by specifying the entry number (#) shown in the first 
field for each displayed entry. If you request that an entry be added, you 
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are prompted for each field in turn. If you press RETURN in response to 
this prompt, you return to the main uuins tall menu. 

The response to the prompt, concerning the line to use for the call, can be 
either “A,” for an ACU, or the device number of the tty to be used for the 
connection. 


Enable the Serial Line 

The next step is to enable the serial line for logins. For example, to enable 
Idevlttyla , enter: 

# enable tty2a 


Your computer can now receive calls from remote terminals or computers 
and prompt for a login name on Idevltty2a. 


6.5.4 Creating a Dial- Out Site 

To create a dial-out site, you 
® Choose a serial line. 

® Disable the serial line. 

• Edit the serial line entry in the /etc /ttys file. 

Then you place information into several control files to allow use of the 
serial line you have chosen : 

• Add user access information to the USERFILE file. 

• Set access permissions in the L. cmds file. Any permissions listed in 
this file override the uucp default permissions. 

• Create, or modify, the L- devices file. 

• Place information about logins on remote computers in th cL.sys 

Then, you install the dialing information your system uses to call and log in 
to other computers: 

• Set up the dial program . 

® Place dialing abbreviations for remote computers in the L- 
dialcodes file. 
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® Create a transmission schedule in the form of a shell script to be 
called periodically by the cron program. 

With a dial-out line you can call and log in to other computers by using the 
cu(C) command. The cu command uses the L- devices file to locate the 
correct serial line and set the proper line speed when these values are not 
explicitly given on the cu command line. 

The following sections explain how to create some of the necessary files. 
Editing I etc! ttys, file, creating the USERFILE, L.cmds, and L.sys files and 
enabling and disabling the lines is discussed in the previous Section “- 
Creating a Dial-In Line.” 


Note 

You cannot dial-in and out at the same time using the same serial 
line. However, you can alternate between dial-in and dial-out at 
different times of the day by enabling or disabling the serial line as 
needed. 

Make sure you wait at least one minute between each invocation of 
the enable and disable commands. 


Disable the Serial Line 

Disabling the serial line is the first step in creating a dial-out line. To dis- 
able the serial fine, follow these steps: 

1. If you are using a modem, make sure it is installed and tested. 

2. Make sure you are logged in as the super-user. 

3. Disable the serial line by entering: 

# disable /dev/ttyrt/z 

where nn is the number of your serial line. If the line is already dis- 
abled, the command displays an error message that you can safely 
ignore. 

You are now able to call other computers that have dial-in lines by using 
the cu command. For a complete description of the command, see cu(C) 
in the XENIX Reference Manual. 
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Set Up the L- devices File 

The L- devices file defines the devices you intend to use to implement the 
dial-out line. The file is also used by programs in the uucp system (as 
described later). Use the uuinstall utility to set up this file. 

Invoke uuinstall and select option ‘2 5 at the main menu. You are then 
asked if you want to see the current devices. 

Enter c y’ and you see a screen similar to this: 

# Type Line Call-Unit Speed 

0. ACU ttyla ttyla 1200 

1. DIR tty2a 9600 

The program prompts if you want to add or delete an entry in the file. 
Entries are always deleted by specifying the entry number (#) shown in the 
first column on the screen display. 

If you request that an entry be added, you are prompted for the type of 
unit, either an ACU or a direct line. Enter ‘A’ for an automatic calling unit 
(modem) or ‘D’ for a direct line. You must use capital letters. If you press 
RETURN in response to this prompt, you are returned to the main menu. 

If you specify an ACU, you are prompted for the unit number of the calling 
unit and the line. Respond with just the number in each case, the uuinstall 
program supplies the “tty” prefix. If you specify a direct line, you are 
prompted for the line number. 

Finally, you are prompted for the speed of the line. Your response is 
checked and, if it is invalid, you are prompted for a valid response. 


Setup the Dial Program 

Select (or create) the dial program you need for your modem. The default 
dial program is for a Hayes Smartmodem. Other dial programs (for Racal 
Vadic modems) are also supplied. If you need to use a dial program other 
than the default dial, move /usr /lib /uucp /dial to / usr /lib /uucp /dial, hay es. 
You can then move the appropriate dial program to /usr /lib /uucp /dial. 
The directory / usr /lib /uucp also includes relinkable files necessary for pro- 
ducing dial programs for other kinds of modems. Refer to Chapter 7,“- 
Using Peripheral Devices,” in the XENIX Operations Guide and the 
manual pages dial(M) and dial(S) for more information on creating dial 
programs. 
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Create the L- dialcodes File 

The L- dialcodes file defines abbreviations for often used telephone 
prefixes and area codes. You may use these abbreviations in the L.sys file 
when forming the telephone numbers of remote sites. 

The L- dialcodes file may contain one or more entries of the form 

abbreviation dial - sequence 

where abbreviation is any combination of letters and digits that begins with 
a letter, and dial- sequence is any combination of digits that represents a 
telephone prefix, area code or any other part of a telephone number. 

For example, the entry 

ch 555 

defines the abbreviation “ch” to be the telephone prefix “555 .” 

Set up the L- dialcodes using option ‘3’ of the uuinstall program. You are 
prompted as to whether you want to see the current contents of the L- 
dialcodes file. 

If you enter “y, ” you see a screen display similar to the following: 


# Abbreviation Code 

0. Pasa 1818 

1. SntCrz 408 

2. London 011441 


You are then prompted to add or delete an entry in the file. Entries are 
always deleted by specifying the entry number (#), shown in the first 
column of the screen display. If you request that an entry be added, you are 
prompted for the abbreviation and the dialing code for each entry. If you 
press RETURN in response to this prompt, the display returns to the main 
uuinstall menu. 

Note entry zero. In order for our example site to call area code 818 
(Pasadena, CA), the area code must be prefixed with a one (1). Thus, the 
dial code “Pasa” is equivalant to “1818.” 
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In the L.sys file, here is how you would use this example dial code: 

plytch Any ACU 1200 Pasa7931211 login uucp ssword: oaktree 
The next section describ es the file in greater detail. 


6.5.5 Create a Transmission Schedule 

In the uucp system, the uucico program carries out all transmissions 
between your site and other sites, sending and receiving files and com- 
mands as long as there is work for it to do. On a dial-in site, uucico is 
always started whenever a calling site logs in. 

However, on a dial-out site, uucico is only started when explicitly invoked. 
This means you must periodically start up the program on a dial-out site to 
ensure that all transmissions requested by the uucp and uux programs are 
completed. 

You can do this in one of two ways: 

• Invoke the program manually whenever you need it, or 

• Create a shell script and let the cron program invoke uucico 
automatically according to a schedule of transmissions. 

The most convenient method is to let cron run uucico for you. To do this, 
you must choose a schedule of times to invoke uucico then create a file 
/usr/spool/cron/crontabs/uucp for this schedule. This file has the form: 

minutes hour day month day- of- week command- line 

where minutes, hour , day, month, and day- of- week give the exact day of 
the year and time of day to execute the given command-line. Each item, 
except the command- line, must be an integer number within an acceptable 
range, for example, 0 to 59 for minutes. 

A sequence of values for one item may be given by separating the values 
with commas. Also, an asterisk (*) may be given to represent all accept- 
able values. The command- line must be the name of the shell script you 
have created to invoke uucico. 

You can add an entry to the /usr/spool/cron/crontabs/uucp file by using a 
XENIX text editor. For more information about the file, see cron (C) in the 
XENIX Reference Manual. For example, the entry: 

15,45 * * * * /usr/lib/uucp/transmit 

invokes the shell script “transmit” every 30 minutes (at 15 minutes past the 
hour and 45 minutes past the hour)to sites for which requests are pending. 
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The entry: 

0 0 * * * /usr/lib/uucp/transmit 

invokes “transmit” every day at midnight, and the entry: 

15 2,4,6 * * * /usr/lib/uucp/transmit 

invokes the script every day at “2:15,” “4:15,” and “6:15” in the morning. 

A shell script is simply a text file that contains one or more XENIX com- 
mands. For example, this shell script automaticaly invokes uucico: 

uucico -rl -s sitename 


Use the — s option if you want to force a call to the given site even if no 
requests for transmissions exist on the calling site. Note that the — S option 
may be used in place of the — s option if you want to ignore the range of cal- 
ling times given in the L.sys file. Use one uucico command for each site 
you want to call. If you want to call only those sites for which requests 
exist, give a single uucico command, but do not specify the — s or — S 
option with the command. 


Dialing and Dialing Out on the Same Line 

If your uucp system is acting as both a dial-in and dial-out site at different 
times, then the transmit script (see above) should have the form 

disable /dev/tty/w 
uucico -rl -s sitename 


enable /dev/ tty wj 

where nn is the number of your modem’s serial line and sitename is the 
name of the site you want to call. If your computer is strictly a dial-out site, 
then the enable and disable commands are not required. 

For example, this script places a call to the “Chicago” site after disabling 
the serial line: 

disable /dev/ttyla 
uucico -rl -schicago 
enable /dev/ttyla 

The line must be disabled in order to dial out on that line. It must be 
enabled to allow subsequent calls from other computers. 
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You can create a shell script by using any XENIX text editor. For conveni- 
ence, the script should be placed in the / usr/lib/uucp directory and must be 
given execute permissions for everyone. Note that you can also add uucp 
maintenance programs to the script. See the section “Creating 
Maintenance Shell Files” later in this chapter. 


6.5.6 Linking micnet Sites 

To use a uucp system with your micnet network, follow these steps: 

1. Add the entry 

uucp: 

to the maliases file of the computer on which the uucp system is 
installed. 

2. For all other computers in your site, add the entry 

uucp:machine- name: 

to the maliases file. The machine- name must be the name of the 
computer on which the uucp system is installed. This longer form of 
entry may also be used on the computer on which the uucp system is 
installed. 

You can test the uucp system by mailing a short letter to yourself via 
another site. For example, if you are on the site “chicago”, and there is 
another micnet site named “Seattle” in the system, then the command 

mail seattle!chicago!johnd 

sends mail to the “Seattle” site, then back to your “chicago” site, and 
finally to the user “johnd” in your micnet network. Note that a uucp sys- 
tem usually performs its communication tasks according to a fixed 
schedule and may not return mail immediately. 


6.6 Maintaining the System 

This section explains how to maintain the uucp system. In particular, it 
explains how to display and merge the content of uucp log files, how to 
remove old requests and files from the spool directories, and how to solve 
some common problems. 
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You can automate some maintenance tasks by creating shell command 
files and initiating these files with crontab entries. Other tasks require 
manual modification. Some sample shell files are given toward the end of 
this section. 


6.6.1 Displaying and Merging Log Files 

You can display a record of the transmissions requested and completed to 
a given site or user by using the uulog(C) command. The command 
displays the contents of the individual log files created for a given site or 
user and merges these entries with the system log file LOGFILE. The log 
files contain information about queued requests, calls to remote sites, exe- 
cution of uux commands, and file copy results. The command has the form 

uulog -s sitename -u user 

where -s sitename indicates the site whose log files are to be displayed, and 
-miser specifies the user whose log files are to be displayed. K you do not 
specEy a sitename and user , log files for all sites and users are displayed. 
The command places the new log files at the beginning of the existingLOG- 
FILE. 

The log files are originally created in the /usr/ spool/ uucp directory as indi- 
vidual files, but should be copied to the LOGFILE on a regular basis since 
they are not copied automatically. For example, the command 

uulog 

merges all log files and displays their contents. The command 
uulog -schicago 

merges only log files created for the site “chicago . ” 

Note that the system LOGFILE should be removed periodically since it is 
copied each time new log files are put into the file. 


6.6.2 Cleaning the uucp Spool Directory 

You can remove unwanted uucp system files from the uucp spool directory 
by using the uuclean command. The command removes temporary data, 
L OG, system status, and lock files from the spool directory if they are more 
than a given number of hours old. The command has the form 

uuclean -d dir -m -n hours -ppre -xn 
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where -d dir names the directory to be scanned, — m causes mail to be sent 
to the owner of each file removed, -n hours gives the age in hours of files to 
be removed, -p pre causes files with the given prefix to be examined and 
removed, and -xn directs the command to give the /2th level of debugging 
output. Up to 10 file prefixes may be specified with the — p option. If— mis 
used, most mail is sent to the owner of the uucp programs since most files 
put into the spool directory are owned by the owner of the uucp programs. 
This is a result of the setuid bit being set on these programs. The default 
number of hours is 72 (3 days). 

The uuclean program should be run once a day. You can invoke it 
automatically by using a system daemon such as cron. The command 

uuclean -pTM 

removes all temporary data files that are at least three days old. The com- 
mand 


uuclean -pLCK -hi -m 

removes all lock files that are at least an hour old and mails a list of each file 
removed to the owner. 

The uuclean command may also be run as needed to remove unwanted 
files after a system crash or an aborted uucp program. 


6.6.3 Reclaiming Log Files after a Crash 

You can reclaim individual log files after a system crash by changing their 
access mode with the chmod(C) command, then using uulog command. 
After a transmission failure or system crash, the individual log file for the 
transmission may be left with access mode 0222 making it impossible for 
the uulog command to read the file. To reclaim the log file, you must use 
chmod to change the access mode to 0666. You can then let uulog merge 
them with the LOGFILE. 


6.6.4 Reclaiming Data Files aftera Crash 

You can check the status of files transmitted from a remote site and possi- 
bly reclaim some or all of the data lost during an aborted transmission by 
examining system data files. The data files contain the contents of files 
copied from remote sites. These files are temporarily kept in the 
lusr/ spool/ uucp directory and their names have the form 

TM .pid.ddd 
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where pid is a process-id and ddd is a sequential three-digit number start- 
ing at zero for each invocation of uucico and incremented for each file 
received. 

The temporary data files are normally moved to the requested destination 
immediately after the transmission has finished. However, if a transmis- 
sion has failed or the system has crashed, the file remains in the spool direc- 
tory. You can examine the contents of this file with the cat(C) command. 
If desired, you can reclaim the file by moving it to a new location with the 
mv(C) command. Leftover data files that cannot be reclaimed should be 
removed using the uuclean command . 


6.6.5 Checking the Transmission Status 

You can check the status of transmissions between sites in the uucp system 
by examining the system status files. System status files contain informa- 
tion about login, dialup, or sequence check failure, as well as the talking 
status when two machines are conversing. 

The files are kept in the lusrl spool/ uucp directory and their names have the 
form 


STST .sitename 

where sitename is the name of the remote site. 

Normally, system status files are removed after each successful transmis- 
sion, but when a failure occurs, the uucp system copies information about 
the failure to the file and leaves it in the directory. This prevents the Uucp 
system from making further calls to the given site for about an hour, or for 
sequence check failures, until the file is removed. 

To examine the status, use the cat command to display the contents of the 
file. If problems with transmissions are detected it may indicate a problem 
with the modem or with the serial line connected to the modem. 

If a system status file has been left due to a program or system crash, the file 
may prevent all subsequent transmissions to the given site. In this case, the 
file must be removed before attempting further calls. 


6.6.6 Checking for Locked Sites or Devices 

You can make sure the uucp system is not intentionally preventing 
transmissions to a given site or through a given device by examining the sys- 
tem lock files. The uucp system creates a lock file for each site being called 
and for each device being used to call a site. Lock files prevent the uucp 
system from attempting to duplicate conversations with a given site, or 
from placing multiple calls on the same device. 
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The lock files are kept in the lusrf spool fuucp directory and their names 
have the form 

LCK..srr 

where str is either a site name or the name of the calling device. 

Since lock files prevent all calls to a given site or through a given device, it is 
wise to make sure no unnecessary lock files are left in the directory. If a 
transmission has been aborted or the system has crashed, the lock files will 
prevent subsequent transmissions for about 24 hours. If you want to place 
a call before this time, you must remove the file using the uuclean com- 
mand. 


6.6.7 Creating Maintenance Shell Files 

The uulog and uuclean commands can be invoked automatically by plac- 
ing them in a shell file and creating a crontab file for the shell file. The sys- 
tem daemon cron then invokes the commands at the given times and most 
of the simple maintenance will be performed. For example, you can create 
a shell file that removes TM, ST,L CK files daily, as well as the C. orD. files 
for work which cannot be accomplished for reasons such as bad phone 
number and login changes. In this case, the shell file should contain the 
commands 

/usr/lib/uucp/uuclean -pTM -pC. -pD. 

/usr/lib/uucp/uuclean -pST -pLCK -nl2 

Note that the — nl2 option causes the ST and LCK files older than 12 hours 
to be deleted. An appropriate crontab entry must be created in order to 
invoke the shell file automatically. 


6.7 Details ofOperation 

This section describes the details of uucp system program operation. It 
explains the processes used to create system communication and defines 
the files used to support the system. 


6.7.1 uucp Programs 

The uucp system consists of four primary and three secondary programs. 
The primary programs are 

uucp This program creates work and gathers data files in the 
spool directory for the transmission of files. 
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uux This program creates work and execute files, and gathers 

data files for the remote execution of XENIX commands. 

uucico This program executes the work files for data transmission. 

uuxqt This program executes XENIX commands found in execu- 
tion files. 

The secondary programs are 

uulog This program updates the log file with new entries and 
reports on the status of uucp requests. 

uuclean This program removes old files from the spool directory. 

dial This program directs the modem to dial a remote site. 


6.7.2 Uucp Directories and Files 

During execution of the uucp programs, the uucp system uses files from 
the following three directories: 

lusrllibluucp 

This is the directory used for uucp system files and all exe- 
cutable programs other than uucp and uux. 

hisr/ spool! uucp 

This is the spool directory used during uucp execution . 

/usr/ spool/ uucp / .XQTDIR 

This directory is used during execution of execute files. 

Files are created in a spool directory for processing by the uucp daemons. 
There are three types of files used for the execution of work : 

Data files Contain data for transfer to remote sites 

Work files Contain directions for file transfers between 

sites 

Execution files Contain directions for XENIX command execu- 

tions which involve the resources of one or 
more sites. 
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6.7.3 uucp - Site- to- Site File Copy 

The uucp program is the user’s primary interface with the system. The 
uucp program was designed to look like the cp command. The syntax is 

uucp [ option ] . . . source . . . destination 

where source and destination may contain the prefix sitename ! which indi- 
cates the site on which the file or files reside or where they will be copied. 

The options interpreted by uucp are 

-d Make directories when necessary for copying the file. 

-c Do not copy source files to the spool directory, but use the 

specified source when the actual transfer takes place. 

-r Spool only, don’t invoke uucico. 

-m Send mail on completion of the work. 

The following options are used primarily for debugging: 

-s dir Use directory dir for the spool directory. 

-xnum Use num as the level of debugging output. 

The destination may be a directory name, in which case the file name is 
taken from the last part of the source’s name. The source name may con- 
tain special shell characters such as “?*[]”. If a source argument has a 
sitename! prefix for a remote site, the file name expansion will be done on 
the remote site. 

The command 

uucp *.c Chicago !/usr/dan 

sets up the transfer of all files whose names end with .c to the /usr/dan 
directory on the Chicago machine. 

The source and/or destination names may also contain a ~user prefix. This 
translates to the login directory on the specified site. For names with par- 
tial pathnames, the current directory is prepended to the file name. File 
names with ./” are not permitted. 

The command 

uucp chicago!~dan/*.h “dan 
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sets up the transfer of files whose names end with . h in dan’s login directory 
to dan’s local login directory. 

For each source file, the program checks the source and destination 
filenames and the site-part of each to classify the work into one of five 
types: 

1. Copy source to destination on local site. 

2. Receive files from other sites. 

3. Send files to remote sites. 

4. Send files from remote sites to another remote site. 

5. Receive files from remote sites when the source contains special 
shell characters as mentioned above. 

After the work has been set up in the spool directory, the uucico program 
must be started to try to contact the other machine to execute the work. 


Copying Files to a Local Destination 

A cp command is used to do type 1 work. The — d and the — m options are 
not honored in this case. 


Receiving Files from OtherSites 

For type 2 work a one line work file is created for each file requested, and is 
put in the spool directory with the following fields, each separated by a 


blank: 


[i] 

R 

[2] 

The full pathname of the source or a ~user/pathname. The 
~ user part is expanded on the remote site. 

[3] 

The full pathname of the destination file. If the ~user nota- 
tion is used, it will be immediately expanded to be the login 
directory for the user. 

[4] 

. The user’s login name. 

[5] 

A followed by an option list. (Only the — m and — d 

options appear in this list.) 
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Sending Files to Remote Sites 

For type 3 work, a work file is created for each source file and the source 
file is copied into a data file in the spool directory. (A — c option on the 
uucp program prevents the data file from being made. In this case, the file 
will be transmitted from the indicated source.) Pathnames are checked 
using the USERFILE to verify access to the requested directory. The fields 
of each entry are given below. 

[1] s 

[2] The full pathname of the source file. 

[3] The full pathname of the destination or ~user/filename. 

[4] The user’s login name. 

[5] A followed by an option list. 

[6] The name of the data file in the spool directory. 

[7] The file mode bits of the source file in octal print format 
(e.g. 0666). 


Copying Files Between Sites 

For type 4 and 5 work, uucp generates a uucp command line and sends it to 
the remote machine; the remote uucico executes the command line. 


6.7.4 uux — Site To Site Execution 

The uux command is used to set up the execution of a XENIX command 
where the execution machine and/or some of the files are remote. The syn- 
tax of the uux command is 

uux [ - ] [ option ] . . . command- string 

where command- string is made up of one or more arguments. All special 
shell characters such as “<> [’’must be quoted either by quoting the entire 
command string, or by quoting the character as a separate argument. 
Within the command string, the command and file names may contain a 
sitename! prefix. All arguments which do not contain a “!” are not treated 
as files. (They are not copied to the execution machine.) 

A — (dash) is used to indicate that the standard input for the given com- 
mand should be inherited from the standard input of the uux command. 
The only option is essentially for debugging: - xnum directs the command 


6-34 



Building a Communication System 


to use a number (1-9) num as the level of debugging output. The higher the 
number, the more debugging information is provided. 

The command 

pr abc |uux - Chicago Irmail joe 

will set up the output of “pr abc” as standard input to a mail command to 
be executed on site usg. 

uux generates an execute file which contains the names of the files required 
for execution (including standard input), the user’s login name, the desti- 
nation of the standard output, and the command to be executed. This file 
is either put in the spool directory for local execution or sent to the remote 
site using a generated send command (type 3 above). 

For required files which are not on the execution machine, uux will gen- 
erate receive command files (type 2 above). These command-files are put 
on the execution machine and executed by the uucico program. (This 
works only if the local site has permission to put files in the remote spool 
directory as controlled by the remote USERFILE. ) 

The execute file is processed by the uuxqt program on the execution 
machine. It is made up of several lines, each of which contains an 
identification character and one or more arguments. The order of the lines 
in the file is not relevant and some of the lines may not be present. Each 
line is described below. 

User Line 

U user site 

where the user and site are the requestor’s login name and site. 

Required File Line 

F filename real- name 

where the filename is the generated name of a file for the execute machine 
and real- name is the last part of the actual file name (contains no path 
information). Zero or more of these lines may be present in the execute 
file. The uuxqt program checks for the existence of all required files before 
the command is executed. 
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Standard InputLine 

I filename 

The standard input is either specified by a “<” in the command-string or 
inherited from the standard input of the uux command if the — option is 
used. If a standard input is not specified, / dev / null is used. 

Standard OutputLine 

O filename sitename 

The standard output is specified by a “> ” within the command-string. If a 
standard output is not specified, Idevlnull is used. (Note that the use of 
“>>” is not implemented.) 

Command Line 

C command [ arguments ] . . . 

The arguments are those specified in the command string. The standard 
input and standard output does not appear on this line. All required files 
are moved to the execution directory (a subdirectory of the spool direc- 
tory) and the XENIX command is executed using the shell. In addition, a 
shell PATH statement is prepended to the command line as specified in the 
uuxqt program. 

After execution, the standard output is copied or set up to be sent to the 
proper place. 


6.7.5 uucico — Copy In, Copy Out 

The uucico program performs the following major functions: 

- Scan the spool directory for work. 

- Place a call to a remote site. 

- Negotiate a line protocol to be used. 

- Execute all requests from both sites. 

- Log work requests and work completions. 

uucico may be started by a system daemon, by the user (this is usually for 
testing), or by a remote site. (The uucico program should be specified as 
the shell field in the /etc/passwd file for the uucp logins.) 
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When started with the — rl option, the program is considered to be in MAS- 
TER mode. In this mode, a connection is made to a remote site. If started 
by a remote site, the program is considered to be in SLAVE mode. 

The MASTER mode operates in one of two ways. If no site name is 
specified (the — s option not specified) the program scans the spool direc- 
tory for sites to call. If a site name is specified, that site is called, and works 
only be done for that site. 


The uucico program must generally be started directly by the user or by 
another program, such as a shell script invoked by cron. There are several 
options used for execution : 


-rl Start the program in MASTER mode. This is used when 

uucico is started by a program or cron shell. 

-ssitename Do work only for site sitename. If —s is specified, a call to 
the specified site is made even if there is no work for site 
sitename in the spool directory, but call only when times 
in the L.sys file permit it. This is useful for polling sites 
which do not have the hardware to initiate a connection. 


Ssitename Do work only for site sitename. If— S is specified, a call to 
the specified site is made even if there is no work for the 
site in the site in the spool directory. Unlike — s, this 
option ignores the call times for the sitename given in the 
L. sys file. 


The following options are used primarily for debugging: 
-d dir Use directory dir for the spool directory. 

-xnum Use num as the level of debugging output 


The next part of this section describes the major steps within the uucico 
program. 


Scanning For Work 

The names of the work related files in the spool directory have the format 
type . sitename grade number 

where type may be “C” for copy command file, “D” for data file, “X” for 
execute file, sitename is the remote site, grade is a character, and number is 
a four-digit, padded sequence number. 
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The file 

C.res45n0031 

is a work file for a file transfer between the local machine and the “res45” 
machine. 

The scan for work is done by looking through the spool directory for work 
files (files with prefix “C.”). A list is made of all sites to be called, uucico 
calls the site specified by the — s or — S option and process the correspond- 
ing work files. 


Calling a Remote Site 

The call is made using information from several files which reside in the 
uucp program directory. At the start of the call process, a lock is set to for- 
bid multiple conversations between the same two sites. The lock filename 
has the form 

LCK ..str 

where str is the device name. The file is in the lusrl spool /uucp directory. 

The site name is found in the L.sys file. The information contained for 
each site is 

[1] Site name 

[2] Times to call the site (days-of-week and times-of-day) 

[3] Device or device type to be used for call 

[4] line speed 

[5] phone number if field [3] is “ACU,” or the device name 
(same as field [3]) if not 

[6] Login information (multiple fields) 

The time field is checked against the present time to see if the call should be 
made. 


The phone number may contain abbreviations (for example, mh, py, bos- 
ton) which get translated into dial sequences using the L- dialcodes file. 

The L- devices file is scanned using device type and line speed fields from 
the L.sys file to find an available device for the call. The program trys all 
devices which satisfy these fields until the call is made or until no more 
devices can b e tried . If a device is successfully opened , a lock file is created 
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so that another copy of uucico will not try to use it. If the call is complete, 

the login information in the last field of L.sys is used to login. 

The conversation between the two uucico programs begins with a 
handshake started by the SLAVE site. The SLAVE sends a message to let 
the MASTER know it is ready to receive the site identification and conver- 
sation sequence number. The response from the MASTER is verified by 
the SLAVE and if acceptable, protocol selection begins. The SLAVE can 
also reply with a call-back required message, in which case the current 
conversation is terminated. 


Select Line Protocol 

The remote site sends a message 
P proto- list 

where proto - list is a string of characters, each representing a line protocol. 

The calling program checks the protocol list for a letter corresponding to 
an available line protocol and returns a use protocol message. The mes- 
sage has the form 

U code 

where code is either a one character protocol letter or “N” which means 
there is no common protocol. 


Processing Work 

The initial role of MASTER or SLAVE for the work processing is the mode 
in which each program starts. (The MASTER has been specified by the 
— rl option.) The MASTER program does a work search similar to the one 
used in the section “Scanning For Work”. 

There are five messages used during the work processing, each specified by 
the first character of the message. They are 

S Send a file 

R Receive a file 

C Copy complete 

X Execute a uucp command 

H Hangup 
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The MASTER sends “R,” “S,” or “X” messages until all work from the 
spool directory is complete, at which point an “H” message is sent. The 
SLAVE replies with the first letter of the request and either the letter “Y” 
or “N” for yes or no. For example, the message “SY” indicates that it is 
okay to send a file. While in SLAVE mode, the standard error of uucico is 
redirected to the file lusr/spooUuucpIA UDIT. 

The send and receive replies are based on permission to access the 
requested file/directory using the USERFILE and read/write permissions 
of the file/directory. After each file is copied into the spool directory of the 
receiving site, a copy-complete message is sent by the receiver of the file. 
The message “CY” will be sent if the file has successfully been moved from 
the temporary spool file to the actual destination. Otherwise, a “CN” mes- 
sage is sent. (In the case of “CN,” the transferred file will be in the spool 
directory with a name beginning with “TM.)” The requests and results are 
logged on both sites. 

The hangup response is determined by the SLAVE program by a work scan 
of the spool directory. If work for the remote site exists in the SLAVE’S 
spool directory, an “HN” message is sent and the programs switch roles. If 
no work exists, an “HY” response is sent. 


Terminating a Conversation 

When an “HY” message is received by the MASTER it is echoed back to 
the SLAVE and the protocols are turned off. Each program sends a final 
“OO” message to the other. The original SLAVE program cleans up and 
terminates. The MASTER proceeds to call other sites and process work as 
long as possible or terminate if a — s option was specified. 


6.7.6 uuxqt — uucp Command Execution 

The uuxqt program is used to process execute files generated by uux. The 
uuxqt program is started by the uucico program. The program scans the 
spool directory for execute files (prefix X . ). Each one is checked to see if 
all the required files are available and if so, the command line or send line is 
executed. 

The execute file is described in the section 6.74 “uux - Site to Site Execu- 
tion” above. 

The execution is accomplished by executing the shell command 
sh -c 

with the command line after appropriate standard input and standard out- 
put have been opened. If a standard output is specified, the program will 
create a send command or copy the output file as appropriate. 
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6.7.7 Security 

The uucp system, left unrestricted, allows any outside user to execute any 
commands and copy in/out any file which is readable/writable by the uucp 
login user. It is up to the individual sites to be aware of this and apply the 
protections that they feel are necessary. 

There are several security features available aside from the normal file 
mode protections. These must be set up by the installer of the uucp system. 

The login for uucp does not get a standard shell. Instead, the uucico pro- 
gram is started, and receives a special, restricted shell. Therefore, the only 
work that can be done is through uucico. 

A path check is done on file names that are to be sent or received. The 
USERFILE supplies the information for these checks. The USERFILE 
can also be set up to require call-back for certain login-ids. See section 
6.7.2, “Uucp Directories and Files. ” 

A conversation sequence count can be set up so that the called system can 
be more confident of the caller’s identity. 

The uuxqt program comes with a list of commands that it executes. The list 
of allowable commands can be altered with the L. cmds file. 

A PATH shell statement is prepended to the command line as specified in 
the uuxqt program. 

The L.sys file should be owned by uucp and have mode 0400 to protect the 
phone numbers and login information for remote sites. (The uucp, 
uucico, uux, and uuxqt programs should be also owned by uucp and have 
thesetuidbit set.) 
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The C- Shell 


7.1 Introduction 

The C-shell program, csh, is a command language interpreter for XENIX 
system users. The C-shell, like the standard XENIX shell sh, is an interface 
between you and the XENIX commands and programs. It translates com- 
mand lines entered at a terminal into corresponding system actions, gives 
you access to information, such as your login name, home directory, and 
mailbox, and lets you construct shell procedures for automating system 
tasks. 

This appendix explains how to use the C-shell. It also explains the syntax 
and function of C-shell commands and features, and shows how to use 
these features to create shell procedures. The C-shell is fully described in 
csh (C) in the XENIX Reference Manual. 


7.2 Invoking the C- shell 

You can invoke the C-shell from another shell by using the csh command. 
To invoke the C-shell, enter: 

csh 

at the standard shell’s command line. You can also direct the system to 
invoke the C-shell for you when you log in. If you have given the C-shell as 
your login shell in your /etc/passwd file entry, the system automatically 
starts the shell when you login. 

After the system starts the C-shell, the shell searches your home directory 
for the command files .cshrc and .login. If the shell finds the files, it exe- 
cutes the commands contained in them, then displays the C-shell prompt. 

The .cshrc file typically contains the commands you wish to execute each 
time you start a C-shell, and the .login file contains the commands you 
wish to execute after logging in to the system. For example, the following is 
the contents of a typical .login file: 

set ignoreeof 

set mail=(/usr/ spool/mail/bill) 
set time=15 
set history=10 
mail 


This file contains several set commands. The set command is executed 
directly by the C-shell; there is no corresponding XENIX program for this 
command. Set sets the C-shell variable “ignoreeof” which shields the C- 
shell from logging out if Ctrl-d is hit. Instead of Ctrl-d, the logout com- 
mand is used to log out of the system. By setting the “mail” variable, the 
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C-shell is notified that it is to watch for incoming mail and notify you if new 
mail arrives. 

Next the C-shell variable “time” is set to 15 causing the C-shell to automat- 
ically print out statistics lines for commands that execute for at least 15 
seconds of CPU time. The variable “history” is set to 10 indicating that the 
C-shell will remember the last 10 commands typed in its history list, 
(described later). 

Fin ally, the XENIX mail program is invoked . 

When the C-shell finishes processing the .login file, it begins reading com- 
mands from the terminal, prompting for each with : 


% 


When you log out (by giving the logout command) the C-shell prints: 
logout 

and executes commands from the file . logout if it exists in your home direc- 
tory. After that, the C-shell terminates and XENIX logs you off the system. 


7.3 Using Shell Variables 

The C-shell maintains a set of variables. For example, in the above discus- 
sion, the variables “history” and “time” had the values 10 and 15. Each 
C-shell variable has as its value an array of zero or more strings. C-shell 
variables may be assigned values by the set command, which has several 
forms, the most useful of which is: 

set name = value 


C-shell variables may be used to store values that are to be used later in 
commands through a substitution mechanism. The C-shell variables most 
commonly referenced are, however, those that the C-shell itself refers to. 
By changing the values of these variables you can directly affect the 
behavior of the C-shell. 

One of the most important variables is “path”. This variable contains a list 
of directory names. When you enter a command name at your terminal, 
the C-shell examines each named directory in turn, until it finds an execut- 
able file whose name corresponds to the name you entered. The set com- 
mand with no arguments displays the values of all variables currently 
defined in the C-shell. 
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The following example shows typical default values : 

argv () 
home /usr/bill 
path (. /bin /usr/bin) 
prompt % 
shell /bin/csh 
status 0 


This output indicates that the variable “path” begins with the current direc- 
tory indicated by dot ( . ), then /bin, and / usr/bin . Your own local com- 
mands may be in the current directory. Normal XENIX commands reside 
in / bin and /usr/bin. 

Sometimes a number of locally developed programs reside in the directory 
lusr /local. If you want all C-shells that you invoke to have access to these 
new programs, place the command: 

set path=(. /bin /usr/bin /usr/local) 

in the .cshrc file in your home directory. Try doing this, then logging out 
and back in. Enter: 

set 

to see that the value assigned to “path” has changed. 

You should be aware that when you log in the C-shell examines each direc- 
tory that you insert into your path and determines which commands are 
contained there, except for the current directory which the C-shell treats 
specially. This means that if commands are added to a directory in your 
search path after you have started the C-shell, they will not necessarily be 
found. If you wish to use a command which has been added after you have 
logged in, you should give the command : 

rehash 

to the C-shell. Rehash causes the shell to recompute its internal table of 
command locations, so that it will find the newly added command. Since 
the C-shell has to look in the current directory on each command anyway, 
placing it at the end of the path specification usually works best and 
reduces overhead. 

Other useful built in variables are “home” which shows your home direc- 
tory, and “ignoreeof” which can be set in your .login file to tell the C-shell 
not to exit when it receives an end-of-file from a terminal. The variable 
“ignoreeof” is one of several variables whose value the C-shell does not 
care about; the C-shell is only concerned with whether these variables are 
set or unset. 
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Thus, to set “ignoreeof” you simply enter: 

set ignoreeof 
and to unset it enter: 

unset ignoreeof 


Some other useful built-in C-shell variables are “noclobber” and “mail”. 
The syntax: 

> filename 

which redirects the standard output of a command just as in the regular 
shell, overwrites and destroys the previous contents of the named file. In 
this way, you may accidentally overwrite a file which is valuable. If you 
prefer that the C-shell not overwrite files in this way you can : 

set noclobber 

in your .login file. Then entering: 
date > now 

causes an error message if the file now already exists. You can enter: 
date > ! now 

if you really want to overwrite the contents of now. The “> !” is a special 
syntax indicating that overwriting or “clobbering” the file is ok. (The space 
between the exclamation point (!) and the word “now” is critical here, as 
“!now” would be an invocation of the history mechanism, described 
below, and have a totally different effect.) 


7.4 Using the C- Shell History List 

The C-shell can maintain a history list into which it places the text of previ- 
ous commands. It is possible to use a notation that reuses commands, or 
words from commands, in forming new commands. This mechanism can 
be used to repeat previous commands or to correct minor typing mistakes 
in commands. 

The following figure gives a sample session involving typical usage of the 
history mechanism of the C-shell. Boldface indicates user input: 
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% cat bug.c 

main() 

{ 

printf ("hello); 

> 

% cc !$ 
cc bug.c 

bug.c(4) :error 1: newline in constant 
% ed !$ 
ed bug.c 
28 

3s/);/"&/p 

printf ("hello"); 
w 
29 

q 

% !c 
cc bug.c 
% a. out 
hello % !e 
ed bug.c 
29 

3s/lo/lo\\n/p 

printf ("hello\n"); 
w 
31 

q 

% !c — o bug 
cc bug.c -o bug 
% size a. out bug 

a. out: 5124 + 614 + 1254 = 6692 = 0xlb50 
bug: 5124 + 616 + 1252 - 6692 = 0xlb50 
% Is -1 !* 

Is -1 a. out bug 

-rwxr-xr-x 1 bill 7648 Dec 19 09:41 a. out 

-rwxr-xr-x 1 bill 7650 Dec 19 09:42 bug 

% bug 
hello 

% pr bug.c | lpt 

lpt:^ Command not found. 

% lptlpr 
pr bug.c | lpr 

o/ 

/o 


In this example, we have a very simple C program that has a bug or two 
the file bug.c, which we cat out on our terminal. We then try to run the 
compiler on it, referring to the file again as “ !$”, meaning the last argument 
to the previous command. Here the exclamation mark (!) is the history 
mechanism invocation metacharacter, and the dollar sign ($) stands for 
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the last argument, by analogy to the dollar sign in the editor which stands 
for the end-of-line. 

The C-shell echoed the command, as it would have been typed without use 
of the history mechanism, and then executed the command. The compila- 
tion yielded error diagnostics, so we now edit the file we were trying to com- 
pile, fix the bug, and run the C compiler again, this time referring to this 
command simply as “ !c”, which repeats the last command that started with 
the letter “c”. 

If there were other commands beginning with the letter “c” executed 
recently, we could have said “!cc” or even “!cc:p” which prints the last 
command starting with “cc” without executing it, so that you can check to 
see whether you really want to execute a given command . 

After this recompilation, we ran the resulting a. out file, and then noting 
that there still was a bug, ran the editor again. After fixing the program we 
ran the C compiler again, but tacked onto the command an extra “-o bug” 
telling the compiler to place the resultant binary in the file bug rather than 
a. out. In general, the history mechanisms may be used anywhere in the 
formation of new commands, and other characters may be placed before 
and after the substituted commands. 

We then ran the size command to see how large the binary program images 
we have created were, and then we ran an “Is -1” command with the same 
argument list, denoting the argument list: 

!* 

Finally, we ran the program bug to see that its output is indeed correct. 

To make a listing of the program, we ran the pr command on the file bug.c. 
In order to print the listing at a lineprinter we piped the output to lpr, but 
misspelled it as “lpt”. To correct this we used a C-shell substitute, placing 
the old text and new text between caret ( ) characters. This is similar to the 
substitute command in the editor. Finally, we repeated the same com- 
mand with: 

H 

and sent its output to the lineprinter. 

There are other mechanisms available for repeating commands. The his- 
tory command prints out a numbered list of previous commands. You can 
then refer to these commands by numb er. There is a way to refer to a previ- 
ous command by searching for a string which appeared in it, and there are 
other, less useful, ways to select arguments to include in a new command. 
A complete description of all these mechanisms is given in csh (C) the 
XENIX Reference Manual. 
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7.5 Using Aliases 

The C-shell has an alias mechanism that can be used to make transforma- 
tions on commands immediately after they are input. This mechanism can 
be used to simplify the commands you enter, to supply default arguments 
to commands, or to perform transformations on commands and their 
arguments. The alias facility is similar to a macro facility. Some of the 
features obtained by aliasing can be obtained also using C-shell command 
files, but these take place in another instance of the C-shell and cannot 
directly affect the current C-shell’s environment or involve commands 
such as cd which must be done in the current C-shell. 

For example, suppose there is a new version of the mail program on the sys- 
tem called newmail that you wish to use instead of the standard mail pro- 
gram mail. If you place the C-shell command 

alias mail newmail 

in your . cshrc file, the C-shell will transform an input line of the form : 
mail bill 

into a call on newmail. Suppose you wish the command Is to always show 
sizes of files, that is, to always use the — s option. In this case, you can use 
the alias command to do: 

alias Is Is -s 

or even: 

alias dir Is -s 

creating a new command named dir. If we then enter: 
dir "'bill 

the C-shell translates this to: 

Is -s /usr/bill 

Note that the tilde (~) is a special C-shell symbol that represents the user’s 
home directory. 

Thus the alias command can be used to provide short names for com- 
mands, to provide default arguments, and to define new short commands 
in terms of other commands. It is also possible to define aliases that con- 
tain multiple commands or pipelines, showing where the arguments to the 
original command are to be substituted using the facilities of the history 
mechanism. 
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Thus the definition: 

alias cd 'cd \!* ; Is ' 

specifies an Is command after each cd command. We enclosed the entire 
alias definition in single quotation marks ( ' ) to prevent most substitutions 
from occurring and to prevent the semicolon (;) from being recognized as a 
metacharacter. The exclamation mark (!) is escaped with a backslash (\) to 
prevent it from being interpreted when the alias command is entered. The 
u \!*” here substitutes the entire argument list to the prealiasing cd com- 
mand; no error is given if there are no arguments. The semicolon separat- 
ing commands is used here to indicate that one command is to be done and 
then the next. Similarly the following example defines a command that 
looks up its first argument in the password file. 

alias whois 'grep \! /etc/passwd' 


The C- shell currently reads the .cshrc file each time it starts up. If you place 
a large number of aliases there, C-shells will tend to start slowly. You 
should try to limit the number of aliases you have to a reasonable number 
(10 or 15 is reasonable). Too many aliases causes delays and makes the sys- 
tem seem sluggish when you execute commands from within an editor or 
other programs. 


7.6 Redirecting Input and Output 

In addition to the standard output, commands also have a diagnostic out- 
put that is normally directed to the terminal even when the standard output 
is redirected to a file or a pipe. It is occasionally useful to direct the diag- 
nostic output along with the standard output. For instance, if you want to 
redirect the output of a long running command into a file and wish to have a 
record of any error diagnostic it produces you can enter: 

command > & file 


The > here tells the C-shell to route both the diagnostic output and 
the standard output into file. Similarly you can give the command: 

command |& lpr 

to route both standard and diagnostic output through the pipe to the line- 
printer. The form: 

command >&! file 

is used when “noclobber” is set and file already exists. 
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Finally, use the form: 

command >> file 

to append output to the end of an existing file. If “noclobber” is set, then 
an error results if file does not exist, otherwise the C-shell creates file. The 
form: 


command >>! file 

lets you append to a file even if it does not exist and “noclobber” is set. 


7.7 Creating Background and Foreground Jobs 

When one or more commands are entered together as a pipeline or as a 
sequence of commands separated by semicolons, a single job is created by 
the C-shell consisting of these commands together as a unit. Single com- 
mands without pipes or semicolons create the simplest jobs. Usually, 
every line entered to the C-shell creates a job. Each of the following lines 
creates a job: 

sort < data 

Is -s | sort -n | head -5 
mail harold 


If the ampersand metacharacter (&) is entered at the end of the com- 
mands, then the job is started as a background job. This means that the C- 
shell does not wait for the job to finish, but instead, immediately prompts 
for another command. The job runs in the background at the same time 
that normal jobs, called foreground jobs, continue to be read and executed 
by the C-shell. Thus: 

du > usage & 

runs the du program, which reports on the disk usage of your working 
directory, puts the output into the file usage and returns immediately with a 
prompt for the next command without waiting for du to finish . The du pro- 
gram continues executing in the background until it finishes, even though 
you can enter and execute more commands in the mean time. Background 
jobs are unaffected by any signals from the keyboard such as the INTER- 
RUPT or QUIT signals. 

The kill command terminates a background job immediately. Normally, 
this is done by specifying the process number of the job you want killed. 
Process numbers can be found with the ps command. 
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7.8 Using Built- In Commands 

This section explains how to use some of the built-in C-shell commands. 

The alias command described above is used to assign new aliases and to 
display existing aliases. If given no arguments, alias prints the list of 
current aliases. It may also be given one argument, such as to show the 
current alias for a given string of characters. For example: 

alias Is 

prints the current alias for the string “Is”. 

The history command displays the contents of the history list. The 
numbers given with the history events can be used to reference previous 
events that are difficult to reference contextually. There is also a C-shell 
variable named “prompt”. By placing an exclamation point (!) in its value 
the C-shell will substitute the number of the current command in the his- 
tory list. You can use this number to refer to a command in a history substi- 
tution. For example, you could enter: 

set prompt='\! % 

Note that the exclamation mark (!) had to be escaped here even within 
back quotes. 

The logout command is used to terminate a login C-shell that has 
“ignoreeof” set. 

The rehash command causes the C-shell to recompute a table of com- 
mand locations. This is necessary if you add a command to a directory in 
the current C-shell’s search path and want the C-shell to find it, since oth- 
erwise the hashing algorithm may tell the C-shell that the command wasn’t 
in that directory when the hash table was computed. 

The repeat command is used to repeat a command several times. Thus to 
make 5 copies of the file one in the file/zve you could enter: 

repeat 5 cat one >> five 
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The setenv command can be used to set variables in the environment. 
Thus: 


setenv TERM adm3a 

sets the value of the environment variable “TERM” to “adm3a”. The pro- 
gram env exists to print out the environment. For example, its output might 
look like this: 

HOME=/usr/bill 

SHELL=/bin/csh 

PATH= :/usr/ucb :/b in :/ usr/b in :/usr/local 

TERM=adm3a 

USER=bill 


The source command is used to force the current C-shell to read com- 
mands from a file. Thus: 

source .cshrc 

can be used after editing in a change to the . cshrc file that you wish to take 
effect b efore the next time you login . 

The time command is used to cause a command to be timed no matter how 
much CPU time it takes. Thus: 

time cp /etc/rc /usr/bill/rc 

displays: 

O.Ou 0.1s 0:01 8% 

Similarly: 

time wc /etc/rc /usr/bill/rc 
displays: 


52 

178 

1347 /etc/rc 

52 

178 

1347 /usr/bill/rc 

104 

356 

2694 total 


O.lu 0.1s 0:00 13% 

This indicates that the cp command used a negligible amount of user time 
(u) and about l/10th of a second system time (s); the elapsed time was 1 
second (0:01). The word count command wc used 0. 1 seconds of user time 
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and 0.1 seconds of system time in less than a second of elapsed time. The 
percentage “13% ” indicates that over the period when it was active the wc 
command used an average of 13 percent of the available CPU cycles of the 
machine. 

The unalias and unset commands are used to remove aliases and variable 
definitions from the C-shell. The command unsetenv removes variables 
from the environment. 


7.9 Creating Command Scripts 

It is possible to place commands in files and to cause C-shells to be 
invoked to read and execute commands from these files, which are called 
C-shell scripts. This section describes the C-shell features that are useful 
when creating C-shell scripts. 


7.10 Using the a rgv Variable 

A csh command script may be interpreted by saying: 
csh script argument ... 

where script is the name of the file containing a group of C-shell commands 
and argument is a sequence of command arguments. The C-shell places 
these arguments in the variable “argv” and then begins to read commands 
from script. These parameters are then available through the same 
mechanisms that are used to reference any other C-shell variables. 

If you make the file script executable by doing: 

chmod 755 script 


or: 


chmod +x script 

and then place a C-shell comment at the beginning of the C-shell script 
(i.e., begin the file with a number sign (#) ) then /bin/csh will automatically 
be invoked to execute script when you enter: 

script 

If the file does not begin with a number sign (#) then the standard shell 
/bin/sh will be used to execute it. 
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7.11 Substituting Shell Variables 

After each input line is broken into words and history substitutions are 
done on it, the input line is parsed into distinct commands. Before each 
command is executed a mechanism known as variable substitution is per- 
formed on these words. Keyed by the dollar sign ($), this substitution 
replaces the names of variables by their values. Thus: 

echo $argv 

when placed in a command script would cause the current value of the vari- 
able “argv” to be echoed to the output of the C-shell script. It is an error 
for “argv” to be unset at this point. 

A number of notations are provided for accessing components and attri- 
butes of variables. The notation: 

%lname 

expands to 1 if name is set or to 0 if name is not set. It is the fundamental 
mechanism used for checking whether particular variables have been 
assigned values. All other forms of reference to undefined variables cause 
errors. 

The notation: 

$#name 

expands to the number of elements in the variable “name”. To illustrate, 
examine the following terminal session (input is in boldface) : 

% set argv=(a b c) 

% echo $?argv 

1 

% echo $#argv 

3 

% unset argv 
% echo $?argv 

0 

% echo $argv 
Undefined variable: argv. 

% 
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It is also possible to access the components of a variable that has several 
values. Thus: 

$argv[l] 

gives the first component of “argv” or in the example above “a”. Similarly: 

$argv[$#argv] 
would give “c”, and: 

$argv[l-2] 
would give: 
a b 

Other notations useful in C-shell scripts are: 

$n 

where n is an integer. This is shorthand for: 

$argv[ n ] 

the Az’th parameter and: 

$* 

which is a shorthand for: 

$argv 
The form: 

$$ 


7-14 



The C- Shell 


expands to the process number of the current C-shell. Since this process 
number is unique in the system, it is often used in the generation of unique 
temporary filenames. 

One minor difference between “$/i” and “$argv[/7 ]” should be noted here. 
The form: “$argv[/7 ]” will yield an error if n is not in the range l-$#argv 
while “$n” will never yield an out-of-range subscript error. This is for 
compatibility with the way older shells handle parameters. 

Another important point is that it is never an error to give a subrange of the 
form: “n-”; if there are less than “n” components of the given variable 
then no words are substituted. A range of the form: “m-n” likewise 
returns an empty vector without giving an error when “m” exceeds the 
number of elements of the given variable, provided the subscript “n” is in 
range. 


7.12 Using Expressions 

To construct useful C-shell scripts, the C-shell must be able to evaluate 
expressions based on the values of variables. Li fact, all the arithmetic 
operations of the C language are available in the C-shell with the same pre- 
cedence that they have in C. In particular, the operations “==” and “!=” 
compare strings and the operators “&&” and “| |” implement the logical 
AND and OR operations. The special operators “=~” and are similar 
to “==” and “!=” except that the string on the right side can have pattern 
matching characters (like *, ? or [ and ]). These operators test whether the 
string on the left matches the pattern on the right. 

The C-shell also allows file inquiries of the form : 

-? filename 

where question mark (?) is replaced by a number of single characters. For 
example, the expression primitive: 

-e filename 

tells whether filename exists. Other primitives test for read, write and exe- 
cute access to the file, whether it is a directory, or if it has nonzero length. 

It is possible to test whether a command terminates normally, by using a 
primitive of the form: 

{ command } 

which returns 1 if the command exits normally with exit status 0, or 0 if the 
command terminates abnormally or with exit status nonzero. If more 
detailed information about the execution status of a command is required, 
it can be executed and the “status” variable examined in the next 
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command. Since “$status” is set by every command, its value is always 
changing. 

For the full list of expression components, see csh(C) in the XENIX Refer- 
ence Manual. 


7. 13 Using the C- Shell: A Sample Script 

A sample C-shell script follows that uses the expression mechanism of the 
C-shell and some of its control structures: 

# 

# Copyc copies those C programs in the specified list 

# to the directory "“/backup if they differ from the files 

# already in "“/backup 

# 

set no glob 
foreach i ($argv) 

if ($i P *.c) continue # not a .c file so do nothing 

if (! -r "Vbackup/$i:t) then 

echo $i:t not in backup... not cpYed 
continue 

endif 

cmp -s $i "“/backup/$i:t # to set $status 

if ($status != 0) then 

echo new backup of $i 
cp $i "Ybackup/$i:t 

endif 

end 


This script uses the foreach command, which iteratively executes the 
group of commands between the foreach and the matching end statements 
for each valie value of the variable “i”. I f you want to look more closely at 
what happends during execution of a foreach loop, you can use the debug 
command break to stop execution at any point and the debug command 
continue to resume execution. The value of the iteration variable (z in this 
case) will stay at whatever it was when the last foreach loop was completed. 

The “noglob” variable is set to prevent filename expansion of the members 
of “argv”. This is a good idea, in general, if the arguments to a C-shell 
script are filenames which have already been expanded or if the arguments 
may contain filename expansion metacharacters. It is also possible to 
quote each use of a “$” variable expansion, but this is harder and less reh- 
ab le. 
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The other control construct is a statement of the form: 

if ( expression ) then 
command 


endif 

The placement of the keywords in this statement is not flexible due to the 
current implementation of the C-shell. The following two formats are not 
acceptable to the C-shell: 

if (expression) # Won’t work! 
then 

command 


endif 


and: 


if (expression) then command endif # Won’t work 


The C-shell does have another form of the if statement: 

if ( expression ) command 

which can b e written : 

if ( expression ) \ 
command 


Here we have escaped the newline for the sake of appearance. The com- 
mand must not involve “ |”, or and must not be another control 
command. The second form requires the final backslash (\) to immedi- 
ately precede the end-of-line. 

The more general if statements above also admit a sequence of else-if 
pairs followed by a single else and an endif, for example: 

if ( expression ) then 
commands 

else if ( expression ) then 
commands 


else 

commands 

endif 
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Another important mechanism used in C-shell scripts is the colon (:) 
modifier. We can use the modifier :r here to extract the root of a filename 
or :e to extract the extension. Thus if the variable “i” has the value 
/mnt/foo. bar then 

echo $i $i:r $i:e 
produces: 

/mnt/foo.bar /mnt/foo bar 

This example shows how the :r modifier strips off the trailing “.bar” and 
the :e modifier leaves only the “bar”. Other modifiers take off the last com- 
ponent of a pathname leaving the head :h or all but the last component of a 
pathname leaving the tail :t. These modifiers are fully described in the 
csh(C) entry in the XENIX Reference Manual. It is also possible to use the 
command substitution mechanism to perform modifications on strings to 
then reenter the C-shell environment. Since each usage of this mechanism 
involves the creation of a new process, it is much more expensive to use 
than the colon (:) modification mechanism. It is also important to note 
that the current implementation of the C-shell limits the number of colon 
modifiers on a “$” substitution to 1. Thus: 

% echo $i $i:h:t 
produces: 

/a/b/c /a/b:t 

and does not do what you might expect. 

Finally, we note that the number sign character (#) lexically introduces a 
C-shell comment in C-shell scripts (but not from the terminal). All subse- 
quent characters on the input line after a number sign are discarded by the 
C-shell. This character can be quoted using or “V 5 to place it in an 
argument word. 


7-18 



The C- Shell 


7.14 Using Other Control Structures 

The C- shell also has control structures while and switch similar to those of 
C. These take the forms: 

while ( expression ) 
commands 

end 


and: 


switch (word ) 

case strl: 

commands 

breaksw 


case stm: 

commands 

breaksw 

default: 

commands 

breaksw 


endsw 

For details see the manual section for csh(C). C programmers should note 
that we use breaksw to exit from a switch while break exits a while or 
foreach loop. A common mistake to make in C-shell scripts is to use 
break rather than breaks w in switches. 

Finally, the C-shell allows a goto statement, with labels looking like they 
doinC: 

loop: 

commands 
goto loop 
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7.15 Supplying Input to Commands 

Commands run from C-shell scripts receive by default the standard input 
of the C-shell which is running the script. It allows C-shell scripts to fully 
participate in pipelines, but mandates extra notation for commands that 
are to take inline data. 

Thus we need a metanotation for supplying inline data to commands in C- 
shell scripts. For example, consider this script which runs the editor to 
delete leading blanks from the lines in each argument file: 

# deblank — remove leadingblanks 
foreach i ($argv) 
ed - $i << EOF' 
l,$s/~[ ]*// 
w 

q 

'EOF 

end 

The notation: 

<< 'EOF' 

means that the standard input for the ed command is to come from the text 
in the C-shell script file up to the next line consisting of exactly EOF. The 
fact that the EOF is enclosed in single quotation marks ('), i.e., it is 
quoted, causes the C-shell to not perform variable substitution on the 
intervening lines. In general, if any part of the word following the “<<” 
which the C-shell uses to terminate the text to be given to the command is 
quoted then these substitutions will not be performed. In this case since 
we used the form “1,$” in our editor script we needed to insure that this 
dollar sign was not variable substituted. We could also have insured this by 
preceding the dollar sign ($) with a backslash (\), i.e.: 

l,\$s/~[ ]*// 

Quoting the EOF terminator is a more reliable way of achieving the same 
thing. 


7.16 Catching Interrupts 

If our C-shell script creates temporary files, we may wish to catch interrup- 
tions of the C-shell script so that we can clean up these files. We can then 
do: 


onintrlabel 
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where label is a label in our program. If an interrupt is received the C-shell 
will do a “goto label” and we can remove the temporary files, then do an 
exit command (which is built in to the C-shell) to exit from the C-shell 
script. If we wish to exit with nonzero status we can write: 

exit (1) 

to exit with status 1. 


7.17 Using Other Features 

There are other features of the C-shell useful to writers of C-shell pro- 
cedures. The verbose and echo options and the related — v and -x com- 
mand line options can be used to help trace the actions of the C-shell. The 
—n option causes the C-shell only to read commands and not to execute 
them and may sometimes be of use. 

One other thing to note is that the C-shell will not execute C-shell scripts 
that do not begin with the number sign character (#), that is C-shell scripts 
that do not begin with a comment. 

There is also another quotation mechanism using the double quotation 
mark ("), which allows only some of the expansion mechanisms we have so 
far discussed to occur on the quoted string and serves to make this string 
into a single word as the single quote ( ' ) does. 


7. 18 Starting a Loop at a Terminal 

It is occasionally useful to use the foreach control structure at the terminal 
to aid in performing a number of similar commands. For instance, if there 
were three shells in use on a particular system, / bin/sh , /bin/nsh, and 
/bin/csh , you could count the number of persons using each shell by using 
the following commands: 

grep -c csh$ /etc/passwd 
grep -c nsh$ /etc/passwd 
grep -c -v sh$ / etc/ passwd 

Since these commands are very similar we can use foreach to simplify 
them: 


$ foreach i ('sh$' 'csh$"-v sh$') 

? grep -c $i / etc/passwd 
?end 

Note here that the C-shell prompts for input with “? ” when reading the 
body of the loop. This occurs only when the foreach command is entered 
interactively. 
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Also useful with loops are variables that contain lists of filenames or other 
words. For example, examine the following terminal session: 

% set a=('ls') 

% echo $a 

csh.ncsh.rm/fR 

%ls 

csh.n 

csh.rm 

% echo $#a 

2 

The set command here gave the variable “a” a list of all the filenames in the 
current directory as value. We can then iterate over these names to per- 
form any chosen function . 

The output of a command within back quotation marks ( ' ) is converted by 
the C- shell to a list of words. You can also place the quoted string within 
double quotation marks (") to take each (nonempty) line as a component 
of the variable. This prevents the lines from being split into words at 
blanks and tabs. A modifier :x exists which can be used later to expand 
each component of the variable into another variable by splitting the origi- 
nal variable into separate words at embedded blanks and tabs. 


7.19 Using Braces with Arguments 

Another form of filename expansion involves the characters, and 
These characters specify that the contained strings, separated by commas 
(,) are to be consecutively substituted into the containing characters and 
the results expanded left to right. Thus: 

A{strl,str2, . . .stm}B 

expands to: 

AstrlB Astr2B . . . AstmB 

This expansion occurs before the other filename expansions, and may be 
applied recursively (i.e., nested). The results of each expanded string are 
sorted separately, left to right order being preserved. The resulting 
filenames are not required to exist if no other expansion mechanisms are 
used. This means that this mechanism can be used to generate arguments 
which are not filenames, but which have common parts. 

A typical use of this would be: 

mkdir ~/{hdrs, retrofit, csh} 
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to make subdirectories hdrs, retrofit and csh in your home directory. This 
mechanism is most useful when the common prefix is longer than in this 
example: 

chown root /usr/demo/{filel,file2,...} 


7.20 Substituting Commands 

A command enclosed in accent symbols (') is replaced, just before 
filenames are expanded, by the output from that command. Thus, it is pos- 
sible to do: 

set pwd= v pwd' 

to save the current directory in the variable “pwd” or to do: 
vi grep -1 TRACE *.c v 

to run the editor vi supplying as arguments those files whose names end in 
which have the string “TRACE” in them. Command expansion also 
occurs in input redirected with “<<” and within quotation marks ("). 
Refer to csh(C) in the XENIX Reference Manual for more information. 


7.21 Special Characters 

The following table lists the special characters of csh and the XENIX sys- 
tem. A number of these characters also have special meaning in expres- 
sions. See the csh manual section for a complete list. 

Syntactic metacharacters 

; Separates commands to be executed sequentially 
! Separates commands in a pipeline 

( ) Brackets expressions and variable values 

& Follows commands to be executed without waiting for comple- 
tion 

Filename metacharacters 

/ Separates components of a file’s pathname 

Separates root parts of a filename from extensions 
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? Expansion character matching any single character 

* Expansion character matching any sequence of characters 

[ ] Expansion sequence matching any single character from a set of 
characters 

Used at the beginning of a filename to indicate home directories 
{ } Used to specify groups of arguments with common parts 
Quotation metacharacters 

\ Prevents meta-meaning of following single character 

Prevents meta-meaning of a group of characters 
Like ", but allows variable and command expansion 
Input/output metacharacters 
< Indicates redirected input 

> Indicates redirected output 

Expansion/Substitution Metacharacters 

$ Indicates variable sub stitution 

! Indicates history substitution 

: Precedes sub stitution modifiers 

Used in special forms of history sub stitution 
Indicates command substitution 
Other Metacharacters 

# Begins scratch filenames; indicates C-shell comments 
Prefixes option (flag) arguments to commands 
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Using The Visual Shell 


8.1 What is the Visual Shell? 


The visual shell, vsh, is a menu-driven XENIX shell. This chapter 
describes the use and behavior of the vsh. This chapter assumes that the 
reader is familiar with some general XENIX concepts, specifically the struc- 
ture of XENIX filesystems and the nature of a XENIX ‘command’. No fami- 
liarity with any other shell, however, is assumed. If you are a first-time user 
of the visual shell, please completely read the narrative sections of this 
chapter. 

A ‘shell’ is a program which passes a command to an operating system, and 
displays the result of running the command. The XENIX shells can also 
create ‘pipelines’ for passing the output of one command to another com- 
mand or ‘redirect’ the output into a file. 

The other XENIX shells available are sh and csh. These shells are called 
‘command-line oriented’ shells. This means that the user enters com- 
mands one line at a time. The sh and csh shells are full computer languages 
which require study and some programming knowledge to use effectively. 
These command-line shells are powerful and efficient. 

The vsh is a ‘menu-oriented’ shell. In a menu-oriented shell, the user is 
given the available commands, or some of the available commands. The 
user can run the command, by selecting from the menu. 

The visual shell is a good shell for users who may not want to master a pro- 
gramming language right away just to use XENIX or a specfic XENIX appli- 
cation. All visual shell users should additionally become familiar with 
some command-line shell usage. 

Users familiar with command-line shells are in for a pleasant surprise if 
they try the visual shell. Experienced users will appreciate the efficiency 
and versatility of the visual shell. The distinction is very much akin to the 
difference between a line-oriented text editor and a full-screen editor. 

A menu shell can be used effectively with very little study. On the other 
hand, a menu shell can also restrict the user from using the operating sys- 
tem in creative, possibly more efficient ways. The Microsoft visual shell 
strikes a balance in this regard. The visual shell is designed to do all of the 
things that the command-line shells can do. 


8.2 Getting Started with the Visual Shell 

This section describes how to enter, obtain help about, and leave the visual 
shell. This section also describes what you see on the screen while running 
the visual shell and how the menus work. 
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Note the following convention for specifying keystrokes. Ctrl refers to the 
Ctrl key. Ctrl-C means pressing the Ctrl and ‘c’ keys at the same time. 
ALT refers to the ALT shift key. ALT-H means pressing the ALT and ‘H’ 
keys at the same time. Note the irrelevance of case in entering Menu Selec- 
tion characters. For instance, press either ‘Q’ or ‘q’ to run the “Quit” com- 
mand from the main menu. 


8.2.1 Entering the Visual Shell 


Log in to XENIX. If you are not sure how to log in, consult the Operations 
Guide or have someone knowledgeable about XENIX help you. When you 
have a shell prompt (typically ‘$’ or ‘% ’), the operating system is waiting for 
a command. Enter the command: 

vsh 

and press RETURN. 


8.2.2 Getting Help 

E at anytime you are not sure what to do, either run the “Help” Menu 
Selection or press ALT-H. Refer to the reference section of this chapter 
tor information about the Help command. 


8.2.3 Leaving the VisualShell 

To exit the visual shell select the Quit command from the main menu The 
simplest way to do this is to simply press ‘q’ or ‘Q\ In response to the 
prompt Type Y to confirm”, enter ‘y’ or ‘Y’. If you don’t want to exit the 
visual shell yet (perhaps you pressed ‘q’ by mistake), enter any other char- 
acter but y or Y. If you have invoked the visual shell from another shell 
as described above, you will need to log out from XENIX by entering Ctrl-D 
or ‘logout’ and pressing RETURN. If the visual shell is your default shell 
you will automatically be logged out. 


8.3 The Visual Shell Screen 


8.3.1 Status Line 

The bottom line on the screen is called the ‘status line’. The status line 
displays the name of the current working directory, notifies you if you have 
mail, and gives the date, time and the name of the operating system. 
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8.3.2 Message Line 

The line above the ‘status line’ is called the ‘message line’. The message 
line displays special output from XENIX commands, such as error reports. 


8.3.3 Main Menu 

The next section of the screen above the message line is the ‘main menu’. 
The main menu displays a selection of useful XENIX commands. 

The currently selected menu command is highlighted on the screen. To 
select any command, press the SPACE BAR. The next highlighted com- 
mand is selected. The BACKSPACE key will move to the previous com- 
mand. Move through the menu until you have found the command you 
want. To run the currently selected command, press RETURN. 

You may also enter the first letter of a command to select that command. If 
you enter the first letter of the command, you do not need to press 
RETURN. 

If you enter a letter which does not correspond to a menu selection, the 
message: 

Not a valid option 

is displayed. Try another option. 


8.3.4 Command Option Menu 

When you have selected a command, the main menu is replaced with a 
command option menu. The command option menu gives the options 
available with the specific command. You must fill in the options with 
appropriate responses. 

E you wish to return to the main menu without running the command, 
press Ctrl-C, (cancel). E you want to run the command with the selected 
options press RETURN. 
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The following keystrokes allow editing of option responses. 


Ctrl-I, Ctrl- A, or TAB 
Ctrl- Y or DEL 
Ctrl-L 


Ctrl-K 


Ctrl-P 

Ctrl-O 


Move to next field in options menu. 
Delete character under cursor. 
Move cursor to character to right of 
current position in current option 
field. 

Move cursor to character to left of 
current position in current option 
field. 

Move cursor to word in current 
field to right of the current word. 
Move cursor to word in current 
field to left of the current word . 


8.3.5 Program Output 

While running a command, commands given and output (unless 
redirected) are displayed above the menu and below the view window. The 
output scrolls up: moves from bottom to top. Lines scrolling off the top of 
the output window disappear. 

Visual shell command lines are listed with each argument preceded by the 
number in the argument list enclosed in parentheses. The command is 
named in the output window by the menu command. Hence, if you run the 
command /bin/ls with the argument - R , the output window will display the 
command line as follows: 

Run (1) /bin/ls (2) -R (3) 

To change the command line format to reflect the actual XENIX command 
line generated by the visual shell, use the Options Output menu command. 


8.3.6 View Window 

A menu of currently accessible files and directories can be displayed at the 
top of the screen in alphabetical order, left to right, top to bottom. Note 
that this display is the same as that obtained using the view command. This 
will be referred to as the ‘view window’ in this chapter. If the directory list 
is larger than the current window size, you may scroll through using the key 
commands given below. To reset the window size, use the ‘Window’ main 
menu command. 

The currently selected item is highlighted in the view window. Use the 
arrow keys and other key commands given at the end of this section to 
move the highlight around the window. 
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If a directory is being listed, subdirectories are shown enclosed in square 
brackets. To view a subdirectory, press ‘=’ while the directory is 
highlighted. To return to the previous directory after viewing a subdirec- 
tory, press The parent directory of the current directory is shown as 
*[..]\ The current directory is shown as ‘[.]\ Executable files are preceded 
by an asterisk. The last modification date of the currently selected item is 
given at the right margin of the last line of the window. The name of the 
item in view in the current window is given in the upper right-hand comer 
of the window. 


The view window may also display contents of files. Highlight a file, and 
press < =\ You may scroll through the file using the key commands given 
below. While viewing a file, the highlighted area covers one line. 

If you press < =’ while an executable file is highlighted, that file will be run. 

If the visual shell requires a file or directory name, the currently selected 
View Window item can be automatically entered in the relevent option 
field by pressing any directional movement key following selection of the 
command. This method saves keystrokes and reduces the chance of mak- 
ing a mistake while entering a command. On the other hand, if you wish to 
enter a file or directory in an option field, enter in the name after selecting 
the command. 


Use these keystrokes to select files from the view window: 


WINDOW MOTION KEYS 


Ctrl-Q 

Ctrl-Z 

Ctrl -R Ctrl -E 
Ctrl-RCtrl-S 


Move to start (first item alphabetically) of view window. 
Move to end (last item alphabetically) of view window. 
Scroll view window up. 

Scroll view window down. 

View indicated item, either file or directory. If no view 
window is present, the current working directory is 
displayed. 

Return window display to parent directory of currently 
listed directory. If viewing a file, exit from viewing that 
file. Last view window is returned to. 


DIRECTIONAL MOVEMENT KEYS 


ARROW UP or Ctrl-E 
ARROW DOWN or Ctrl-X 
ARROW LEFT or Ctrl-S 
ARROW RIGHT or Ctrl-D 


Move highlight up in view window. 
Move highlight down in view window. 
Move highlight left in view window. 
Move highlight right in view window. 


Movement beyond the left or right margin will proceed to the next item on 
the previous or next line unless at the edge of the view window. Movement 
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beyond the top or bottom edge of the current window will scroll the view 
window up or down if there are more items in that direction in the view win- 
dow. 

Note that there are two ways to move the highlight around. Either use the 
keypad arrow keys or the cluster of four keys on the far left of the keyboard 
‘e’, ‘x’, ‘s’, and ‘d’ shifted with Ctrl. 

While viewing a file, the directional movement keys for up and left move 
the highlight up, and the keys for down and right move the highlighted line 
down. 


8.4 Visual Shell Reference 


8.4.1 Visual Shell Default Menu 

This section describes the default visual shell menu commands and 
options. The menu options are displayed at the bottom of the screen 
above the status fine. 

To invoke a command, move the highlight forward through the main menu 
using the space bar or the tab key, or backwards using the backspace key. 
Or simply press the first letter of the command . 

Most commands require entering options. Move the cursor to the field 
using the SPACE BAR, TAB key or BACKSPACE key, and enter your 
response. To edit the options, refer to the key commands listed above in 
the section in this chapter labeled “Command Option Menu”. To select 
an item from a View Window listing for insertion in a field, refer to the sec- 
tion in this chapter labelled “ View Window”. 

Note that some options have ‘switches’ with predefined (default) selec- 
tions. The currently selected switch setting is highlighted. The default is 
the parenthesized setting. For instance, in the switch: 

Recursive: (yes) no 

the default is recursive. To change a switch, select the field and press the 
SPACEBAR or BACKSPACE. 


Copy 


The Copy command can copy files and directories. To copy a file, select 
“File” from the options, to copy a directory, select “Directory”. A sub- 
menu then appears. Enter the file or directory you wish copied in the from: 
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field. Enter the file or directory you wish copied to the to: field. Note that if 
the item in the to: field already exists, it is overwritten, so be careful. 

The Copy Directory sub-menu has a switch “recursive”. If this switch is 
set to yes, all sub -directories and their contents below the specified direc- 
tory will b e copied . 


Delete 


The Delete command can remove files and directories. In the DELETE 
name: field, enter the name of the file or directory you want to remove. 
Note that once the file or directory is deleted, the contents are permanently 
removed unless you have another copy, so be careful. 


Edit 


The Edit command invokes the full-screen editor vi. The current direc- 
tory is displayed in the output window. Enter in the option field EDIT 
filename: the n ame of the file you wish to edit using vi. 

To learn vi, refer to “vi: a Screen Editor” in the XENIX User’s Guide , and 
the vi(C) manual page in the XENIX Reference Manual. A vi reference 
card is also available. 


Help 


The Help command (also available by pressing ALT-H at any time), can 
give online help regarding many aspects of visual shell use. The view win- 
dow displays the help file. Use the menu to select the topic you need help 
with. For instance, move the highlight to ‘Keyboard’ using the SPACE 
BAR and press RETURN to view the help file starting at the ‘Keyboard’ sec- 
tion. The ‘Next’ and ‘Previous’ fields in the menu will scroll through the the 
help file, from the present location, one screen at a time. Your work will 
remain undisturbed. To return from Help, press Ctrl-C or select the 
‘Resume’ menu option. 


Mail 


The Mail command enters the XENIX mail system. There are two options: 
“Send” and “Read” For more information about mail, refer to the section 
of the XENIX Users Guide titled “Mail”, or refer to the mail(C) manual 
page. 
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Name 


The Name command renames an existing file or directory. There are two 
fields. From: and To:. Enter the name of the file or directory you want to 
rename in From : and the new name in To:. 


8.4.2 Options 

The Options Main Menu Selection provides four sub -menus. These sub- 
menus run commands which are used infrequently, or which have irrevo- 
cable results. 


Directory Option 


The Directory command has two sub -menus, Make and Usage. 


Make Directory Option: 

This command creates a new directory named what you enter in the name: 
field. 

Usage Directory Option: 

Counts the number of disk blocks in the directories specified in the name: 
field. The format is the same as the XENIX command Is -s. Refer to the 
manual page Is (C) . 


FileSystem Option 


FileSystem has five sub-menus: Create, FilesCheck, SpaceFree, Mount 
and Unmount. 


Create FileSystem Option: 

Create FileSystem makes a XENIX filesystem. The Create command per- 
forms radical system maintenance and may have irrevocable effects. Care 
is advised when using Create FileSystem. 

The functionality is the same as mkfs(C). Consult the mkfs(C) manual 
page before running Create FileSystem. Create FileSystem prompts you 
for device, block size, gap number and block number. Refer to Chapter 3, 
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“Using File Systems”, in the XENIX Operations Guide , for information on 
creating file systems. 


Files Check FileSystem Option: 

FilesCheck checks the consistency of a XENIX filesystem and attempts 
repair if damage is detected. The FilesCheck command performs radical 
system maintenance and may have irrevocable effects. Care is advised 
when using FilesCheck. 

The functionality is the same as fsck(C). Consult the fsck(C) manual page 
before running FilesCheck. FilesCheck prompts you for the device to 
check. 


Output Option: 


The Output Option command has one switch, commands like: VShell 
XENIX”. The default is VShell. IF VShell is set, the vsh form of com- 
mands given appear in the upward scrolling output window. If XENIX is 
specified, the XENIX command line which vsh generated is shown instead. 


Permissions Option 


The Permissions Option command allows changing the access permissions 
on files and directories. The functionality is the same as the chmod(C) 
command. Consult the chmod manual page if you do not understand the 
concept of XENIX permissions. 

In the name: field enter the name of the file or directory you wish to alter 
the permissions on. You may only alter the permissions on files and direc- 
tories you own. There are four switches, who ;, read:, write:, and execute :. 

The who: switch has four settings, All, Me, Group and Others. All is the 
default. All refers to yourself, those with the same group id as yourself and 
others. Me refers to yourself. Group refers to all others with your group id. 
Others refers to those outside your group. 

The read, write and execute switches have two settings, yes and no. The 
default is yes for Me, and no for Group and Others. This grants the given 
type of permission to those specified in the who: switch. No takes away the 
given type of permission from those specified in the who: switch. 
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8.4.3 Print 

The Print command puts a file or files in the queue for your lineprinter. In 
the filename: option field, enter the file or files you want to print. 


8.4.4 Quit 

The Quit command exits the visual shell. The only option is Enter Y to 
confirm:. Enter ‘Y’ or ‘y’ if you really want to quit. Any other key cancels 
the quit. 


8.4.5 Run 

The Run command executes a program or shell script. The name: option 
takes the name of an executable file. In the parameters: option field enter 
flags to pass to the executable file. The output: option can specify a file to 
redirect output to, or another program to send the output to. Enter a verti- 
cal bar ‘ \ in the output field to use the pipe menu. 

It is also possible to run an executable file by highlighting the name of the 
file in the View Window and pressing <= \ 


8.4.6 View 

The View command allows you to inspect without altering the contents of 
files and directories. View is also available at any time for an item 
highlighted in the View Window by pressing <= \ See the section above 
labelled 4 View Window’ for the details of using View. 

To alter the height and characteristics of the View Window, use the ‘Win- 
dow’ menu option. See the section below labelled “Window”. 

If you have invoked View from the menu, enter the name of the file or 
directory you wish to view in the VIEW name: field, or select from a direc- 
tory view window. 

To return from any View action to the previously displayed View Window, 
press the minus key l -’. 

If you View a non-executable binary file, non-ascii characters are 
displayed as the character ‘@\ 
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8.4.7 Window 

The Window command alters the height and redraw characteristics of the 
visual shell View Window. 

The 


WINDOW redraw: Yes (No) 

switch turns redraw of the view window on or off after running a command . 

The heightinlines: field changes the number of lines displayed in the view 
window. The minimum window height is 1 line. The default window 
height is 5 lines. The maximum window height is 15 lines. 


8.4.8 Pipes 

XENIX allows output from one program to be passed to another program 
or to be put in a file. This is called ‘piping’ or ‘pipelining’. If the output is 
placed in a file it is said to be ‘redirected’. Piping is supported in the visual 
shell through the pipe menu. 

The Pipe menu is invoked by entering a vertical bar ‘f character in any 
option field named output:. For instance, the Run main menu and the Pipe 
menu itself have an output: field. The available Pipe menu commands are 
Count, Get, Head, More, Run, Sort and Tail. Each Pipe menu sub- 
command also has an output: field, which allows construction of pipelines 
of arbitrary length . 


8.4.9 Count 

Count counts words, lines and characters in the input pipe. The default is 
all of the above. There is a switch for each type of item to count. The 
Count Pipe Menu option corresponds to the XENIX command wc. Con- 
sult the manual page wc(C) for an explanation . 


8.4.10 Get 

Get looks for patterns in the input pipe. The pattern may be verbatim, or 
you may specify a “regular expression” to look for. Regular expressions 
may contain ‘wildcard’ characters which represent sets of strings. Consult 
the manual page grep(C), for the available wildcard characters. 

The first Get switch is Unmatched (Yes) No. If you specify Yes (the 
default), all lines containing the given pattern will be output. If 
Unmatched is set to off, all lines not containing the given pattern are out- 
put. 
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The second Get switch is ignore case: which suppresses the case while 
looking for the regular expression . The default is off. 

The third Get switch is line numbers : , which reports the line in the input 
stream which the regular expression was matched on. The default is on. 


8.4.11 Head 

Head prints a specified number of lines of the input stream starting from 
the first line. The lines: field maybe set to specify the number of lines at the 
head of the input stream to print. The default is 5 lines. 

The Head Pipe Menu option corresponds to the XENIX command head. 
Consult the manual page head(C) for an explanation. 


8.4.12 More 

More allows viewing an input stream one screen at a time. The More Pipe 
Menu option invokes the XENIX command more. Consult the manual 
page more(C) for an explanation. 


8.4.13 Run 

The Run Pipe Menu option allows the specification of any command not in 
the Pipe menu. The functionality is the same as the visual shell Main Menu 
Option “Run”. 


8.4.14 Sort 

The XENIX sort utility can be invoked through the Sort Pipe menu option. 
The input stream is sorted. 

The first Sort switch is order: < >. Select £ >’, the default, to sort in 
ascending order. Select £ <’ to sort in descending order. 

The second Sort switch suppresses the case of characters in the sort. The 
default is off. 

The third Sort switch sorts the input stream assuming an initial numeric 
field is in the input stream. If this switch is off, initial numbers are sorted in 
ascii order, which means that a line beginning with ‘10’ will be output 
before the line beginning with £ 2’. The default is off. 

The fourth Sort switch sorts the input stream in alphabetical order, rather 
than ascii order. 
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The Sort Pipe Menu option corresponds to the XENIX command sort. 
Consult the manual page sort(C) for an explanation. 


8.4.15 Tail 

Tail prints a specified number of lines of the input stream up to the end of 
the stream. The lines: field may be set to specify the number of lines to 
print. The default is 15 lines. 

The Tail Pipe Menu option corresponds to the XENIX command tail. Con- 
sult the manual page tail(C) for an explanation. 
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ed 


A.l Introduction 

ed is a text editor used to create and modify text. The text is normally a 
document, a program, or data for a program, thus ed is a truly general pur- 
pose program. Note that the line editor ex, available with other XENIX 
packages is very similar to ed, and therefore this chapter can be used as an 
mtroduction to ex as well as to ed. 


A. 2 Demonstration 

This section leadsyou through a simple session with ed, givingyou a feel for 
how it is used and how it works. To begin the demonstration, invoke ed by 
entering: 1 

ed 

This invokes the editor and begins your editing session, ed has no prompt 
unless o string is used on the command line to specify one. A blank line 
prompts you for commands to be entered. Initially, you are editing a tem- 
porary file that you can later copy to any file that you name. This temporary 
file is called the editing buffer,” because it acts as a buffer between the text 
you enter and the file that you will eventually write out your changes to. 
1 ypically, the first thing you will want to do with an empty buffer is add text 
to it. For example, after the prompt, enter: 

a 

this is line 1 
this is line 2 
this is line 3 
this is line 4 
Ctrl-D 

This “appends” four lines of text to the buffer. To view these lines on your 
screen, enter: J 

l,4p 


where the “1,4” specifies a line number range and the p command “prints’ 

the, snp.nfipH mpc nn ^ 


the specified lines on the screen. 
Now enter : 

2p 
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to view line number two. Next enter: 


P 


This prints out the current line on the screen, which happens to be line 
number two. By default, most ed commands operate on only the current 

line. 


A. 3 Basic Concepts 

This section illustrates some of the basic concepts that you need to under- 
stand to effectively use ed. 


A. 3.1 The Editing Buffer 

Each time you invoke ed, an area in the memory of the computer is allo- 
cated for you to perform all of your editing operations. This area is called 
the “editing buffer.” When you edit a file, the file is copied into this buffer 
where you will work on the copy of the original file. Only when you wnte 
out your file, do you affect the original copy of the file. 


A. 3. 2 Commands 

Commands are entered at your keyboard. Like normal XENIX com- 
mands, entry of a command is ended by entering a NEWLINE. After you 
enter NEWLINE the command is carried out. In the following examples, 
we will presume that entry of each command is completed by entering a 
NEWLINE, although this will not be shown in our examples. Most com- 
mands are single characters that can be preceded by the specification of a 
line number or a line number range. By default, most commands operate 
on the “current line” described below in the section “Line Numbers. 
Many commands take filename or string arguments that are used by the 
command when it is executed. 


A.3.3 Line Numbers 

Any time you execute a command that changes the number of lines in the 
editing buffer, ed immediately renumbers the lines. At all times, every lme 
in the editing buffer has a line number. Many editing commands will take 
either single line numbers or line number ranges as prefixing arguments. 
These arguments normally specify the actual lines in the editing buffer that 
are to be affected by the given command. By default, a special line number 
called “dot” specifies the current line. 
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A. 4 Tasks 

This section discusses the tasks you perform in everyday editing. Fre- 
quently used and essential tasks are discussed near the beginning of this 
section. Seldom used and special-purpose commands are discussed later. 


A. 4.1 Entering and Exiting The Editor 

The simplest way to invoke ed is to enter: 
ed 

The most common way, however, is to enter: 
ed filename 

where filename is the name of a new or existing file. 

To exit the editor, all you need to do is enter: 

q 

If you have not yet written out the changes you have made to your file, ed 
warns you that you will lose these changes by displaying the message: 

? 


If you still want to quit, enter another q. In most cases you will want to exit 
by entering: 

w 

q 

so that you first write out your changes and only then exit the editor. 


A. 4.2 Appending Text: a 

Suppose that you want to create some text starting from scratch. This sec- 
tion shows you how to enter text in a file, just to get started. Later we’ll talk 
about how to change it. 

When you first invoke ed, it is like working with a blank piece of paper- 
there is no text or information present. Text must be supplied by the per- 
son using ed, usually by entering the text, or by reading it in from a file. We 
will start by entering some text, and discuss how to read files later. 

In ed terminology, the text being worked on is said to be “kept in a buffer.” 
Think of the buffer as a workspace, or simply as a place where the 
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information that you are going to be editing is kept. In effect, the buffer is 
the piece of paper on which you will write, make changes, and save (write 
to the disk). 

You tell ed what to do to your text by entering instructions called “com- 
mands. 5 ’ Most commands consist of a single letter, each entered on a 
separate line, ed prompts with an asterisk (*). 

The prompt can be turned on and off with the prompt command, P . 

The first command we will discuss is append (a), written as the letter “a 55 
on a line by itself. It means “append (or add) text lines to the buffer, as they 
are entered. 5 Appending is like writing new material on a piece of paper. 

To enter lines of text into the buffer, enter an “a 55 followed by a RETURN, 
followed by the lines of text you want, as shown below: 

a 

Now is the time 

for all good men 

to come to the aid of their party. 


To stop appending, enter a line that contains only a period. The period ( . ) 
tells ed that you have finished appending. (You can also use Ctrl-D, but we 
will use the period throughout this discussion.) If ed seems to be ignoring 
you, enter an extra line with just a period ( . ) on it. You may find you’ve 
added some garbage lines to your text, which you will have to take out later. 

After appending is completed, the buffer contains the following three 
lines: 


Now is the time 

for all good men 

to come to the aid of their party. 

The a and . aren’t there, because they are not text. 

To add more text to what you already have, enter another a command, and 
continue entering your text. 

If you make an error in the commands you enter to ed, it will tell you by 
displaying the message: 

? 

error message 
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A. 4.3 Writing Out a File: w 

You will probably want to save your text for later use. To write out the con- 
tents of the buffer into a file, use the write ( w ) command, followed by the 
name of the file that you want to write to. This copies the contents of the 
buffer to the specified file, destroying any previous contents of the file. For 
example, to save the text in a file named text , enter: 

w text 

Leave a space between w and the filename, ed responds by displaying the 
number of characters it has written out. For instance, ed might respond 
with 


68 

(Remember that blanks and the newline character at the end of each line 
are included in the character count.) Writing out a file just makes a copy of 
the text-the buffer’s contents are not disturbed, so you can go on adding 
text to it. If you invoked ed with the command “ed filename” then by 
default, a w command by itself will write the buffer out Xo filename. 

Note that ed at all times works on a copy of a file, not the file itself. No 
change in the contents of a file takes place until you give a w command. 
Writing out the text to a file from time to time as it is being created is a good 
idea. If the system crashes, or you make a mistake (not saving the file on 
disk), you will lose all of the text in the buffer, but any text that was written 
out to a file is relatively safe. 


A. 4. 4 Leaving The Editor: q 

To terminate a session with ed, save the text you’re working on by writing it 
to a file using the w command, then enter : 

q 


The system responds with the XENIX prompt character. If you try to quit 
without writing out the file ed will display: 

9 

At that point, write out the text if you want to save it; if not, entering 
another “q” will get you out of the editor. 
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Exercise 

Enter ed and create some text by entering: 
a 

. . . text . . . 


Write it out by entering: 
w filename 

Then leave ed by entering: 

q 

Next, use the cat command to display the file on your termin al screen to see 
that everything has worked. 


A. 4. 5 Editing A New File: e 

A common way to get text into your editing buffer is to read it in from a file. 
This is what you do to edit text that you have saved with the w command in a 
previous session. The edit ( e ) command places the entire contents of a file 
in the buffer. If you had saved the three lines “Now is the time” etc., with a 
w 

command in an earlier session, the ed command: 
e text 

would place the entire contents of the file text into the buffer and respond 
with 


68 

which is the number of characters in text. If anything is already in the 
buffer , it is deleted first. 

If you use the e command to read a file into the buffer, then you don’t need 
to use a filename after a w command, ed remembers the last filename used 
in an e command, and w will write to this file. Thus, a good way to operate 
is this: 


ed 

e file 

[editing session ] 
w 

q 
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This way, you can enter w from time to time and be secure in the knowledge 
that if you entered the filename right in the beginning, you are writing out to 
the proper file each time. 


A.4.6 Changing the File to Write Out to: f 

You can find out the last file written to at any time using the file ( f ) com- 
mand. Just enter f without a filename. You can also change the name of 
the remembered filename with f. Thus, a useful sequence is: 

ed precious 
f junk 

which gets a copy of the file named precious, then uses f to save the text in 
the file junk . The original file will be preserved as precious. 


A. 4.7 Reading in a File: r 

Sometimes you want to read a file into the buffer without destroying what is 
already there. This function is useful for combining files. This is done with 
the read (r) command. The command: 

r text 

reads the file text into your editing buffer and adds it to the end of whatever 
is already in the buffer. 

For example, suppose you have performed a read after an edit: 

e text 
r text 

The buffer now contains two copies of text (i. e . , six lines) : 

Now is the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 

Like the w and e commands, after the reading operation is complete r 
prints the number of characters read in. 
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Exercise 

Experiment with the e command by reading and printing various files. You 
may get the following error message : 

Iname 

cannot open input file 

where name is the name of a nonexistent file. This means that the file 
doesn’t exist, typically because you spelled the filename wrong, or perhaps 
because you do not have permission to read from or write to that file. Try 
alternately reading and appending, to see how they work. Verify that the 
command: 

ed file. text 

is equivalent to 

ed 

e file. text 


A. 4. 8 Displaying Lines On The Screen: p 

Use the “print”( command to print the contents of the editing buffer (or 
parts of it) on the terminal screen. Specify the lines where you want print- 
ing to begin and where you want it to end, separated by a comma and fol- 
lowed by the letter “p”. Thus, to print the first two lines of the buffer 
(that is, lines 1 through 2) enter: 

l,2p 

ed displays: 

Now is the time 
for all good men 


Suppose you want to print all the lines in the buffer. You could use “l,3p” 
as shown above if you knew there were exactly 3 lines in the buffer. But you 
will rarely know how many lines there are, so ed provides a shorthand sym- 
bol for the line number of the last line in the buffer-the dollar sign ($). Use 
it as shown below: 

i,$p 
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This will print all the lines in the buffer (from line 1 to the last line). If you 
want to stop the printing before it is finished, press the INTERRUPT key. 
ed then displays: 

7 

interrupt 

and waits for the next command. 

To print the last line of the buffer, enter: 

$p 

You can print any single line by entering the line number, followed by a p. 
Thus: 


IP 

produces the response: 

Now is the time 

which is the first line of the buffer. 

In fact, ed lets you abbreviate even further: you can print any single line by 
entering just the line number; there’s no need to enter the letter p. If you 
enter: 


$ 

ed prints the last line of the buffer. 

You can also use $ in combinations like: 

$-l,$p 

which prints the last two lines of the buffer. This helps when you want to 
see how far you are in your entering. 

The next step is to use address arithmetic to combine the line numbers like 
dot ( . ) and dollar sign ($) with plus (+) and minus (-). (Note that “dot” is 
shorthand for the current line, and is discussed in a later section.) Thus: 


$-1 


prints the next to last line of the current file (that is, one line before the line 
$). For example, to recall how far you were in a previous editing session : 


$-5,$p 
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prints the last six lines. (Be sure you understand why it’s six, not five.) If 
there aren’t six lines in the file, an error message is displayed. 

The command: 

.-3,.+3p 

prints from three lines before the current line (line dot) to three lines after. 
The plus (+) can be omitted. Thus: 

•-3,.3p 

is identical in meaning. 


Another area in which you can save entering effort in specifying lines is to 
use plus and minus as line numbers by themselves. For example: 


by itself is a command to move back one line in the file. In fact, you can 
string several minus signs together to move back that many lines. For 
example: 


moves back three lines, as does: 

-3 


Thus: 


-3,+3p 


is also identical to 
?.-3p+3p 


A. 4. 9 Displaying The Current Line: dot ( . ) 

Suppose your editing buffer still contains the following six lines: 

Now is the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 
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If you enter: 

l,3p 

ed displays: 

Now is the time 

for all good men 

to come to the aid of their party. 

Try entering: 

P 

This prints: 

to come to the aid of their party. 

which is the third line of the buffer. In fact, it is the last (most recent) line 
that you have done anything with. You can repeat this p command without 
line numbers, and ed will continue to print line 3. 

This happens because ed maintains a record of the last line that you did 
anything to (in this case, line 3, which you just printed) so that it can be 
used instead of an explicit line number. The line most recently acted on is 
referred to with a period ( . ) and is called “dot.” Dot is a line number in the 
same way that dollar ($) is; it means “the current line” or loosely, “the line 
you most recently did something to.” You can use it in several ways. One 
way is to enter: 

.,$p 

This prints all the lines from (and including) the current line clear to the 
end of the buffer. In our example, these are lines 3 through 6. 

Some commands change the value of dot, while others do not. The p com- 
mand sets dot to the number of the last line printed. In the example above, 
p sets dot to 6. 

Dot is often used in combinations like this one: 

.+1 

Or equivalently: 

.+lp 
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This means, “print the next line” and is one way of stepping slowly through 
the editing buffer. You can also enter: 

-1 

This means, “print the line before the current line.” This enables you to go 
backwards through the file if you wish. Another useful command is shown 
below: 


.-3,.-lp 

which prints the previous three lines. 

Don ’t forget that all of these change the value of dot. You can find out what 
dot is at any time by entering: 


ed responds by printing the value of dot. Essentially, p can be preceded by 
zero, one, or two line numbers. If no line number is given, ed prints the 
“current line” the line that dot refers to. If one line number is given (with 
or without the letter p), ed prints that line (and dot is set there); and if two 
line numbers are given, ed prints all the lines in that range (and sets dot to 
the last line printed). If two line numbers are specified, the first cannot be 
bigger than the second. 

Pressing RETURN once causes printing of the next line. It is equivalent to : 
■+lp 

Try it. Next, try entering a minus sign ( - ) by itself; it is equivalent to enter- 
ing: 


.-lp 
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Exercise 

Create some text using the a command, and experiment with the p com- 
mand. You will find, for example, that you can’t print line 0, or a line 
beyond the end of the buffer, and that attempting to print lines in reverse 
order using “3, lp, ” does not work . 


A. 4. 10 Deleting Lines : d 

Suppose you want to remove three extra lines in the buffer. Use the delete 
(d) command. Its action is similar to that of p, except that d deletes lines 
instead of printing them. The lines to be deleted are specified for d exactly 
as they are for p. Thus, the command: 

4,$d 

deletes lines 4 through the end. There are now three lines left in our exam- 
ple, and you can check by entering: 

1,$P 

Notice that $ now is line 3! Dot is set to the next line after the last line 
deleted, unless the last line deleted is the last line in the buffer. In that case, 
dot is set to $. 


Exercise 

Experiment with the a, e, r, w, p, and d commands until you are sure that 
you know what they do, and until you understand how dot ( . ), dollar ($), 
and line numbers are used. 

Try using line numbers with a, r, and w, as well. You will find that a 
appends lines after the line number that you specify (rather than after dot) ; 
that r reads in a file after the line number you specify (not necessarily at the 
end of the buffer); and that w writes out exactly the lines you specify, not 
the whole buffer. These variations are sometimes useful. For instance, 
you can insert a file at the beginning of a buffer by entering: 

Or filename 

and you can enter lines at the beginning of the buffer by entering: 

0a 

[input text here] 
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Notice that entering: 


.w 

is very different from entering: 


w 

since the former writes out only a single line and the latter writes out the 
whole file. 


A. 4. 11 Performing Text Substitutions: s 

One of the most important ed commands is the substitute ( s ) command. 
This is the command that is used to change individual words or letters 
within a line or group of lines. It is the command used to correct spelling 
mistakes and entering errors. 

Suppose that, due to a typing error, line 1 is: 

Now is th time 

The letter “e” has been left off of the word “the” You can use s to fix this 
up as follows: 

ls/th/the/ 

This substitutes for the characters “th” the characters “the” in line 1. To 
verify that the substitution has worked, enter: 

P 


to get: 


Now is the time 

which is what you wanted. Notice that dot must be the line where the sub- 
stitution took place, since the p command printed that line. Dot is always 
set this way with the s command. 

The syntax for the substitute command follows: 

[ starting- line,ending- line ] s/ pattern / replacement/ cmds 

Whatever string of characters is between the first pair of slashes is replaced 
by whatever is between the second pair, in all the lines between starting- 
line and ending- line. Only the first occurrence on each line is changed. 
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however. Changing every occurrence is discussed later in this section. The 
rules for line numbers are the same as those for p, except that dot is set to 
the last line changed. (If no substitution takes place, dot is not changed. 
This displays the error message: 

9 

search string not found 


Thus, you can enter: 

1 , $s/speling/ spelling/ 

and correct the first spelling mistake on each line in the text. 

If no line numbers are given, the s command assumes we mean “make the 
substitution on line dot” so it changes things only on the current line. This 
leads to the following sequence: 

s/ something/ something else/ p 

which makes a correction on the current line, then prints it to make sure 
the correction worked out right. If it didn’t, you can try again. (Notice that 
the p is on the same line as the s command. With few exceptions, p can fol- 
low any command; no other multicommand lines are legal.) 

It is also legal to enter: 

s/ string// 

which means “change the first string of characters to nothing” or, in other 
words, remove them. This is useful for deleting extra words in a line or 
removing extra letters from words. For instance, if you had 

Nowxx is the time 

you could enter: 

s/xx//p 

to show: 

Now is the time 

Notice that two adjacent slashes mean “no characters” not a space. There 
is a difference. 
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Exercise 

Experiment with the substitute command. See what happens if you substi- 
tute a word on a line with several occurrences of that word . 

For example, enter: 

a 

the other side of the coin 
s/the/on the/p 
This results in: 

on the other side of the coin 

A substitute command changes only the first occurrence of the first string. 
You can change all occurrences by adding a g (for “global” to the s com- 
mand, as shown below: 

s/.../.../g 

Try using characters other than slashes to delimit the two sets of characters 
in thes command. Anything should work except spaces or tabs. 


A. 4. 12 Searching 

Now that you have been shown the substitute command, you can move on 
to another important concept: context searching. 

Suppose you have the original three-line text in the buffer: 

Now is the time 

for all good men 

to come to the aid of their party. 

Suppose you want to find the line that contains the word “their” so that you 
can change it to the word “the” With only three lines in the buffer, it’s 
pretty easy to keep track of which line the word “their” is on. But if the 
buffer contains several hundred lines, and you have been making changes, 
deleting and rearranging lines, you would no longer really know what this 
line number would be. Context searching is simply a method of specifying 
the desired line, regardless of its number, by specifying a textual pattern 
contained in the line. 

The way to “search for a line that contains this particular string of charac- 
ters” is to enter: 

/ string of characters we want to find/ 
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For example, the ed command : 

/their/ 

is a context search sufficient to find the desired line. It will locate the next 
occurrence of the characters between the slashes (that is, “their”). Note 
that you do not need to enter the final slash. The above search command is 
the same as entering: 

/their 

The search command sets dot to the line on which the pattern is found and 
prints it for verification : 

to come to the aid of their party . 

“Next occurrence” means that ed starts looking for the string at line “.+1,” 
searches to the end of the buffer, then continues at line 1 and searches to 
line dot. (That is, the search “wraps around” from $ to 1.) It scans all the 
lines in the buffer until it either finds the desired line, or gets back to dot. If 
the given string of characters can’t be found in any line, ed displays the 
error message: 

9 

search string not found 

Otherwise, ed displays the line it found. You can also search backwards in 
a file for search strings by using question marks instead of slashes. For 
example: 

?thing? 

searches backwards in the file for the word “thing” as does: 

?thing 

This is especially handy when you realize that the string you want is back- 
wards from the current line. 

The slash and question mark are the only characters you can use to delimit 
a context search, though you can use any character in a substitute com- 
mand . If you get unexpected results using any of the characters : 

* . $ [ * \ & 

read Section A. 5, “Context and Regular Expressions.” 


A - 17 



XENIX User’s Guide 


You can do both the search for the desired line and a substitution at the 
same time, as shown below: 

/ their/s/their/the/p 

This displays: 

to come to the aid of the party. 

The above command contains three separate actions. The first is a context 
search for the desired line, the second is the substitution, and the third is 
the printing of the line. 

The expression “/their/” is a context search expression. In their simplest 
form, all context search expressions are a string of characters surrounded 
by slashes. Context searches are interchangeable with line numbers, so 
they can be used by themselves to find and print a desired line, or as line 
numbers for some other command, like s . They were used both ways in the 
previous examples. 

Suppose the buffer contains the three familiar lines: 

Now is the time 

for all good men 

to come to the aid of their party. 

The ed line numbers: 

/Now/+l 

/good/ 

/party/- 1 


are all context search expressions, and they all refer to the same line (line 
2). To make a change in line 2, enter: 

/Now/ + Is/ good/b ad/ 


or 


/ good/ s/ good/b ad/ 


or 


/ p arty/- ls/good/b ad/ 
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The choice is dictated only by convenience. For instance, you could print 
all three lines by entering: 

/Now/,/party/p 


or 


/Now/,/Now/+2p 

or any similar combination. The first combination is better if you don’t 
know how many lines are involved . 

The basic rule is that a context search expression is the same as a line 
number, so it can be used wherever a line number is needed . 

Suppose you search for: 

/listing/ 

and when the line is printed, you discover that it isn’t the “listing” that you 
wanted, so it is necessary to repeat the search. You don’t have to reenter 
the search, because the construction: 

// 

is a shorthand expression for “the previous pattern that was searched for” 
whatever it was. This can be repeated as many times as necessary. You can 
also go backwards, since: 

?? 

searches for the same pattern, but in the reverse direction. 

You can also use / /, as the left side of a substitute command, to mean “the 
most recent pattern.” For example, examine: 

/listing/ 

ed prints the line containing "listing". 
s//good/p 

This changes “listing” to “good.” To go backwards and change “listing” to 
“good” enter: 

??s//good/ 
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Exercise 

Experiment with context searching. Scan through a body of text with 
several occurrences of the same string of characters using the same context 
search. 

Try using context searches as line numbers for the substitute, print, and 
delete commands. (Context searches can also be used with the r, w, and a 
commands.) 

Try context searching using Itextl instead of / text /. This scans lines in the 
buffer in reverse order instead of normal order, which is sometimes useful 
if you go too far while looking for a string of characters. It’s an easy way to 
back up in the file you’re editing. 

If you get unexpected results with any of the characters 

. $ [ * \ & 

read Section A. 5, “Context and Regular Expressions.” 


A. 4. 13 Changing and Ins erting Text: c and i 

This section discusses the change ( c ) command, which is used to change 
or replace one or more lines, and the insert ( i ) command, which is used 
for inserting one or more lines. 


The c command is used to replace a number of lines with different lines that 
you type at the terminal. For example, to change lines “.+1” through “$” 
to something else, enter: 

.+l,$c 

type the lines of text you want here . . . 


The lines you enter between the c command and the dot ( . ) will replace the 
originally addressed lines. This is useful in replacing a line or several lines 
that have errors in them. 

If only one line is specified in the c command, then only that line is 
replaced. (You can enter as many replacement lines as you like.) Notice 
the use of a period to end the input. This works just like the period in the 
append command and must appear by itself on a new line. If no line 
number is given, the current line specified by dot is replaced. The value of 
dot is set to the last line you typed in. Note that the terminating period and 
the line referenced by dot are completely different: the first is used simply 
to terminate a command, the second points at a specific line of text. 
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The i command is similar to the append command. For example: 
/string/i 

type the lines to be inserted here ... 


inserts the given text before the next line that contains “string . 55 The text 
between i and the terminating period is inserted before the specified line. If 
no line number is specified, dot is used. Dot is set to the last line inserted. 


Exercise 

The c command is like a combination of delete followed by insert. Experi- 
ment to verify that : 

start, end d 
i 

[text] 


is almost the same as: 


start, end c 
[text] 


These are not precisely the same, if the last line gets deleted. 

Experiment with a and i to see that they are similar, but not the same. 
Observe that: 

line- number a 
[text] 


appends after the given line, while: 


line- number i 
[text] 
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inserts before it. If no line number is given, i inserts before line dot, while a 
appends after line dot. 


A. 4. 14 Moving Lines : m 

The move ( m ) command lets you move a group of lines from one place to 
another in the buffer. Suppose you want to put the first three lines of the 
buffer at the end instead. You could do it by entering: 

l,3wtemp 

$rtemp 

1,3d 

where temp is the name of a temporary file. However, you can do it easily 
with them command: 

l,3m$ 

This will move lines 1 through 3 to the end of the file. 

The general case is: 

start- line, end- linemafter - this- line 

There is a third line to be specified: the place where the moved text gets 
put. Of course, the lines to be moved can be specified by context searches. 
If you had: 

First paragraph 
end of first paragraph. 

Second paragraph 
end of second paragraph. 

you could reverse the two paragraphs like this: 

/Second/, /end of second/m/First/-l 

Notice the -1. The moved text goes after the line mentioned. Dot gets set 
to the last line moved. Your file will now look like this: 

Second paragraph 
end of second paragraph 
First paragraph 
end of first paragraph 
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As another example of a frequent operation, you can reverse the order of 
two adjacent lines by moving the first line after the second line. Suppose 
that you are positioned at the first line. Then: 

m+ 

moves line dot to one line after the current line dot. K you are positioned 
on the second line: 

m — 

moves line dot to one line after the current line dot. 

The m command is more efficient than writing, deleting and rereading. 
The main difficulty with the m command is that if you use patterns to 
specffy both the lines you are moving and the target, you have to take care 
to specify them properly, or you may not move the lines you want. The 
result of a bad m command can be a mess. Doing the job one step at a time 
makes it easier for you to verify, at each step, that you accomplished what 
you wanted. It is also a good idea to issue a w command before doing any- 
thing complicated ; then if you make a mistake, it’s easy to b ack up to where 
you were. 

For more information on moving text, see Section A .4. 18, “Marking Your 
Spot in a File:k” in this Appendix. 


A. 4. 15 Performing Global Commands: gandv 

The “global” commands g and v are used to execute one or more editing 
commands on all lines that either contain g or do not contain v, a specified 
pattern. 

For example, the command: 
g/XENIX/p 

prints all lines that contain the word “XENIX.” The pattern that goes 
between the slashes can be anything that could be used in a line search or in 
a substitute command ; exactly the same rules and limitations apply. 

For example: 

gA./p 

prints all the troff formatting commands in a file. For an explanation 
of the use of the caret O and the backslash (\), see Section A. 5, “Context 
and Regular Expressions” in this Appendix. 
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The v, command is identical to g, except that it operates on those lines that 
do not contain an occurrence of the pattern. (Mnemonically, the “v” can 
be thought of as part of the word “in v erse”. 

For example: 

vA./p 

prints all the lines that do not begin with a period (i.e. , the actual text lines). 

Any command can follow g or v. For example, the following command 
deletes all lines that begin with 

gA./d 

This command deletes all empty lines: 
g/~$/d 


Probably the most useful command that can follow a global command is 
the substitute command. For example, we could change the word “Xenix” 
to “XENIX” everywhere, and verify that it really worked, with: 

g/Xenix/ s//XENIX/gp 


Notice that we used / / in the substitute command to mean “the previous 
pattern” in this case, “Xenix.” The p command executes on each line that 
matches the pattern, not just on those in which a substitution took place. 

The global command makes two passes over the file. On the first pass, all 
lines that match the pattern are marked. On the second pass, each marked 
line is examined in turn, dot is set to that line, and the command executed. 
This means that it is possible for the command that follows a g or v com- 
mand to use addresses, set dot, and so on, quite freely. For example: 

g/\P/+ 
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prints the line that follows each “.P” command (the signal for a new para- 
graph in some formatting packages). Remember that plus (+) means “one 
line past dot.” And: 

g/topic/? \.H?p 

searches for each line that contains the word “topic” scans backwards 
until it finds a line that begins with a “.H” (a heading) and prints it, thus 
showing the headings under which “topic” is mentioned. Finally: 

gA.EQ/+,A.EN/-p 

prints all the lines that lie between lines beginning with “.EQ” and “.EN” 
formatting commands. 

The g and v commands can also be preceded by line numbers, in which 
case the lines searched are only those in the range specified. 

It is possible to give more than one command under the control of a global 
command. For example, suppose the task is to change “x” to “y” and “a” 
to “b” on all lines that contain “thing.” Then: 

g/thing/s/x/y/X 

s/a/b/ 

is sufficient. The backslash ( \ ) signals the g command that the set of com- 
mands continues on the next line; the g command terminates on the first 
line that does not end with a backslash. 

Note that you cannot use a substitute command to insert a new line within a 
g command. Watch out for this. 

The command: 

g/x/s//y/\ 

s/a/b/ 

does not work as you might expect. The remembered pattern is the last pat- 
tern that was actually executed, so sometimes it will be “x” (as expected), 
and sometimes it will be “a” (not expected). You must spell it out, as 
shown: 

g/x/s/x/y/X 

s/a/b/ 
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It is also possible to execute a, c and i commands as part of a global com- 
mand. As with other multiline constructions, add a backslash at the end of 
each line except the last. Thus, to add an “.nf” and “.sp” command before 
each “.EQ” line, enter: 

g/\EQ/i\ 

.nf\ 

.sp 

There is no need for a final line containing a period ( . ) to terminate the i 
command, unless there are further commands to be executed under the 
global command. 


A. 4. 16 Displaying Tabs and Control Characters: 1 

ed provides two commands for printing the contents of the text you are 
editing. You should already be familiar with p, in combinations like: 

1,$P 

to print all the lines you are editing, or: 
s/abc/def/p 

to change “abc” to “def” on the current line. Less familiar is the “list” ( 1) 
command which gives slightly more information than p. In particular, 1 
makes visible characters that are normally invisible, such as tabs and back- 
spaces. If you list a line that contains some of these, 1 prints each tab as 
“>” and each backspace as “<” This makes it much easier to correct the 
sort of entering mistake that inserts extra spaces adjacent to tabs, or inserts 
a b ackspace followed by a space. 

The 1 command also “folds” long lines for printing. Any line that exceeds 
72 characters is printed on multiple lines; each printed line except the last is 
terminated by a backslash ( \ ), so you can tell it was folded. This is useful 
for printing lines longer than the width of your terminal screen. 

Occasionally, the 1 command will print a string of numbers preceded by a 
backslash, such as \07 or \16. These combinations are used to make visible 
characters that normally don’t print, like form feed, vertical tab, or bell. 
Each backslash-number combination represents a single ASCII character. 
Note that numbers are octal and not decimal. When you see such charac- 
ters, be aware that they may have surprising meanings when printed on 
some terminals. Often, their presence indicates an error in entering, 
because they are rarely used. 
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A. 4. 17 Undoing Commands :u 

Occasionally, you will make a substitution in a line, only to realize too late 
that it was a mistake. The undo ( u ) command, lets you “undo’’ the last 
substitution. Thus the last line that was substituted can be restored to its 
previous state by entering: 

u 

This command does not work with the g and v commands. 


A.4.18 Marking YourSpotina File: k 

The mark command, k, provides a facility for marking a line with a particu- 
lar name, so that you can later reference it by name, regardless of its actual 
line number. This can be handy for moving lines and keeping track of them 
as they move. For example: 

kx 

marks the current line with the name “x.” If a line number precedes the k, 
that line is marked. (The mark name must be a single lowercase letter.) 
You can refer to the m arked line with the notation : 

'x 


Note the use of the single quotation mark ( ' ) here. Marks are very useful 
for moving things around. Find the first line of the block to be moved and 
then mark it with: 

ka 

Then find the last line and mark it with : 
kb 

Go to the place where the text is to be inserted and enter: 

'a,'bm. 


A line can have only one mark name associated with it at any given time. 
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A. 4.19 Trans ferring Lines : t 

We mentioned earlier the idea of saving lines that are hard to type or used 
often, to cut down on entering time, ed provides another command, called 
t (for transfer) for making a copy of a group of one or more lines at any 
point. This is often easier than writing and reading. 

The t command is identical to the m command, except that instead of mov- 
ing lines it simply duplicates them at the place you named. Thus: 

l,$t$ 

duplicates the entire contents that you are editing. 

A common use for t is to create a series of lines that differ only slightly. For 
example, you can enter: 

a 

Now is the time for all good men to come to the aid of their party. 

t. [make a copy] 

s/men/women/ [change it a bit] 

t. [make third copy] 

s/Now is/yesterday was/ [change it a bit] 

Your file will look like this: 

Now is the time for all good men to come to the aid of their party. 

Now is the time for all good women to come to the aid of their party. 
Yesterday was the time for all good women to come to the aid of their party 


A.4.20 Escaping to the Shell: ! 

Sometimes it is convenient to temporarily escape from the editor to exe- 
cute a XENIX command without leaving the editor. The shell escape (!) 
command, provides a way to do this. 

If you enter: 

\command 

your current editing state is suspended, and the XENIX command you 
asked for is executed. When the command finishes, ed will signal you by 
printing another exclamation (!). At that point, you can resume editing. 
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A. 5 Contextand Regular Expressions 

You may have noticed that things don’t work right when you use characters 
such as the period ( . ), the asterisk (*), and the dollar sign ($) in context 
searches and with the substitute command. The reason is rather complex, 
although the solution to the problem is simple, ed treats these characters 
as special. For instance, in a context search or the first string of the substi- 
tute command, the period ( . ) means “any character” not a period, so: 

/x.y/ 

means a line with an “x” any character, and a “y” not just a line with an “x” 
a period, and a “y” A complete list of the special characters that can cause 
problems follows: 

A . $ [ * \ / 


The next few subsections discuss how to use these characters to describe 
patterns of text in search and substitute commands. These patterns are 
called “regular expressions” and occur in several other important XENIX 
commands and utilities, including grep(C), sed( C) (See the XENIX Refer- 
ence Manual). 

Recall that a trailing g after a substitute command causes all occurrences to 
be changed. With: 

s/this/that/ 


and 


s/this/that/g 

The first command replaces the first “this” on the line with “that. ” If there 
is more than one “this” on the line, the second form with the trailing g 
changes all of them. 
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Either form of the s command can be followed by p or 1 to print or list the 
contents of the line. For example, all of the following are legal and mean 
slightly different things: 

s/this/that/p 

s/this/that/1 

s/this/that/gp 

s/this/that/gl 

Make sure you know what the differences are. 

Of course, any s command can be preceded by one or two line numbers to 
specify that the substitution is to take place on a group of lines. Thus: 

1 , $s/ mispell/ misspell/ 

changes the first occurrence of “mispell” to “misspell” in each line of the 
file. But: 

l,$s/mispell/misspell/g 

changes every occurrence in each line (and this is more likely to be what you 
wanted). 

If you add a p or 1 to the end of any of these substitute commands, only the 
last line changed is printed, not all the lines. We will talk later about how to 
print all the lines that were modified. 


A. 5.1 Period: (.) 

The first metacharacter that we will discuss is the period ( . ). On the left 
side of a substitute command, or in a search, a period stands for any single 
character. Thus the search: 

/x.y/ 
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finds any line where “x” and “y” occur separated by a single character, as 
in: 


x+y 
x-y 
x y 
xzy 

and so on. 

Since a period matches a single character, it gives you a way to deal with 
funny characters printed by 1. Suppose you have a line that appears as: 

th\07is 

when printed with the 1 command, and that you want to get rid of the \07, 
which represents an ASCII bell character. 

The most obvious solution is to enter: 

s/\07// 

but this will fail. Another solution is to retype the entire line. This is 
guaranteed, and is actually quite reasonable if the line in question isn’t too 
big. But for a very long line, reentering is not the best solution. This is 
where the metacharacter comes in handy. Since \07 really represents a 
single character, if we enter: 

s/th.is/ this/ 

the job is done. The period matches the mysterious character between the 
“h” and the “i” whatever it is. 

Since the period matches any single character, the command : 

s /./,/ 

converts the first character on a line into a comma (,), which very often is 
not what you intended. The special meaning of the period can be removed 
by preceding it with a backslash. 

As is true of many characters in ed, the period ( . ) has several meanings, 
depending on its context. This line shows all three: 

.s/././ 

The first period is the line number of the line we are editing, which is called 
“dot.” The second period is a metacharacter that matches any single char- 
acter on that line. The third period is the only one that really is an honest, 
literal period. (Remember that a period is also used to terminate input 
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from the a and i commands.) On the right side of a substitution, the period 
( . ) is not special. If you apply this command to the line: 

Now is the time. 

the result is: 

.ow is the time. 

which is probably not what you intended. To change the period at the end 
of the sentence to a comma, enter: 

s/\./,/ 

The special meaning of the period can be removed by preceding it with a 
backslash. 


A. 5.2 Backslash: \ 

Since a period means any character” the question naturally arises: what 
do you do when you really want a period? For example, how do you con- 
vert the line: 

Now is the time. 


into 


Now is the time? 

The backslash (\), turns off any special meaning that the next character 
might have; in particular, “ \” converts the from a 
“match anything” 

into a literal period, so you can use it to replace the period in “Now is the 
time.” like this: 

s/\./?/ 

The pair of characters \. ” is considered by ed to be a single real period. 

The backslash can also be used when searching for lines that contain a spe- 
cial character. Suppose you are looking for a line that contains: 


at the start of a line. The search : 
/. DE/ 
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isn’t adequate, for it will find lines like: 

JADE 

FADE 

MADE 

because the matches the letter “A” on each of the lines in question. 

But if you enter: 

A.DE/ 

only lines that contain “.DE” are found. 

The backslash can be used to turn off special meanings for characters other 
than the period. For example, consider finding a line that contains a 
backslash. The search: 

/V 

will not work, because the backslash (\) isn’t a literal backslash, but 
instead means that the second slash (/) no longer delimits the search. By 
preceding a backslash with another backslash, you can search for a literal 
backslash: 

AV 

You can search for a forward slash (/) with : 

A// 

The backslash turns off the special meaning of the slash immediately fol- 
lowing, so that it doesn’t terminate the slash-slash construction prema- 
turely. 

A miscellaneous note about backslashes and special characters: you can 
use any character to delimit the pieces of an s command; there is nothing 
sacred about slashes. (But you must use slashes for context searching.) For 
instance, in a line that contains several slashes already, such as: 

//exec //sys.fort.go // etc... 

you could use a colon as the delimiter. To delete all the slashes, enter: 
s:/::g 


The result is: 

exec sys.fort.go etc.. . 
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When you are adding text with a or i or c, the backslash has no special 
meaning, and you should only put in one b ackslash for each one you want. 

Exercise 

Find two substitute commands, each of which converts the line: 

\x\.\y 
into the line: 

\x\y 

Here are several solutions; you should verify that each works: 

s/\\\.// 

s/x../x/ 

s/..y/y/ 

A. 5. 3 DollarSign: $ 

The dollar sign “$” stands for “the end of the line.” Suppose you have the 
line: 

Now is the 

and you want to add the word “time” to the end. Use the dollar sign ($) as 
shown below: 

s/$/ time/ 

to get: 

Now is the time 
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A space is needed before “time” in the substitute command, or you will 
get: 

Now is thetime 

You can replace the second comma in the following line with a period 
without altering the first. 

Now is the time, for all good men, 

The command needed is: 

s/,$/./ 

to get: 

Now is the time, for all good men . 

The dollar sign ($), here, provides context to make specific which comma 
we mean. Without it, the s command would operate on the first comma to 
produce: 

Now is the time, for all good men, 

To convert: 

Now is the time. 

into: 

Now is thetime? 
as we did earlier, we can use: 
s/.$/?/ 


Like the period ( . ), the dollar sign ($) has multiple meanings depending on 
context. In the following line: 

$s/$/$/ 

the first “$” refers to the last line of the file, the second refers to the end of 
that line, and the third is a literal dollar sign to be added to that line. 
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A. 5. 4 Caret: 

The caret ( ) stands for the beginning of the line. For example, suppose 
you are looking for a line that begins with “the. ” If you enter: 

/the/ 

you will probably find several lines that contain “the” in the middle before 
arriving at the one you want. But, by entering: 

/"the/ 

you narrow the context, and thus arrive at the desired line more easily. 

The other use of the caret ( " ) enables you to insert something at the begin- 
ning of a line. For example: 

s/7/ 

places a space at the beginning of the current line. 

Metacharacters can be combined. To search for a line that contains only 
the characters: 

.P 

you can use the command : 

A.P$/ 


A.5.5 Star:* 

Suppose you have a line that looks like this: 
text x y text 

where text stands for lots of text, and there are an indeterminate number 
of spaces between the “x” and the “y.” Suppose the job is to replace all the 
spaces between x ’ and “y” with a single space. The line is too long to 
retype, and there are too many spaces to count. 

This is where the metacharacter “star” (*) comes in handy. A character 
followed by a star stands for as many consecutive occurrences of that char- 
acter as possible. To refer to all the spaces at once, enter: 

s/x *y/xy/ 
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The “ ” means “as many spaces as possible.” Thus “x *y” means an “x” as 
many spaces as possible, then a “y” 

The star can be used with any character, not just a space. If the original 
example was: 

text x y text 

then all minus signs (-) can be replaced by a single space with the com- 
mand: 


s/x-*y/xy/ 


Finally, suppose that the line was: 

text x y text 

If you enter: 

s/x.*y/xy/ 

The result is unpredictable. If there are no other x’s or y’s on the line, the 
substitution will work, but not necessarily. The period matches any single 
character so the matches as many single characters as possible, and 
unless you are careful, it can remove more of the line than you expected. 
For example, if the line is: 

xtextx y texty 

then entering: 

s/x.*y/xy/ 

takes everything from the first “x” to the last “y” which, in this example, is 
more than you wanted. 

The solution is to turn off the special meaning of the period ( . ) with the 
backslash (\): 

s/x\.*y/xy/ 

Now the substitution works, for means “as many periods as possi- 
ble.” 

There are times when the pattern “. *” is exactly what you want. For exam- 
ple, to change: 

Now is the time for all good men .... 
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into: 


Now is the time. 

use “ . *” to remove everything after the “for . ” 
s/ for.*/./ 


There are a couple of additional pitfalls associated with the star (*). Most 
notable is the fact that “as many as possible” means zero or more. The fact 
that zero is a legitimate possibility, is sometimes rather surprising. For 
example, if our line contained : 

x>QtextnxOn)Qtext 

where the squares represent spaces, and we entered : 
s/xQ*y/x0y/ 

the first “xy” matches this pattern, for it consists of an “x” zero spaces, and 
a “y.” The result is that the substitute acts on the first “xy” and does not 
touch the later one that actually contains some intervening spaces. 

The way around this is to specify a pattern like: 

/x TTT v/ 

which says an “x” a space, then as many more spaces as possible, and then 
a “y” (i.e. , one or more spaces). 

The other pitfall associated with the star (*) again relates to the fact that 
zero is a legitimate number of occurrences of something followed by a star. 
The command: 

s/x*/y/g 

when applied to the line: 

abcdef 

produces: 

yaybycydyeyfy 
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which is almost certainly not what was intended. The reason for this is that 
zero is a legitimate number of matches, and there are no x’s at the begin- 
ning of the line (so that gets converted into a “y,” nor between the “a” and 
the “b” (so that gets converted into a “y,” and so on. If you don’t want zero 
matches, enter: 

s/xx*/y/g 

since “xx*” is one or more x’s. 


A. 5. 6 Brackets: [and] 

Suppose that you want to delete any numbers that appear at the beginning 
of all lines of a file. You might try a series of commands like: 

l,$sA*// 

l,$sA*// 

l,$sA*// 

and so on, but this is clearly going to take forever if the numbers are long. 
Unless you want to repeat the commands over and over, until finally all the 
numbers are gone, you must get all the digits on one pass. That is the pur- 
pose of the brackets. 

The construction: 

[0123456789] 

matches any single digit ; the whole thing is called a “character class. ” With 
a character class, the job is easy. The pattern “[0123456789]*” matches 
zero or more digits (an entire number), so: 

l,$s/~[0123456789]*// 

deletes all digits from the beginning of all lines. 

Any characters can appear within a character class, and there are only 
three special characters (\ ], and -) inside the brackets; even the backslash 
doesn’t have a special meaning. To search for special characters, for 
example, you can enter: 

/[■\$*[]/ 


It’s a nuisance to have to spell out the digits, so you can abbreviate them as 
[0-9]; similarly, [a-z] stands for the lowercase letters, and [A-Z] for 
uppercase. 
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Within [], the “[” is not special. To get a “]” (or a into a character 
class, make it the first character. 

You can also specify a class that means “none of the following characters. ” 
This is done by beginning the class with a caret ( * ). For example: 

ro-9] 

stands for “any character except a digit. ” Thus, you might find the first line 
that doesn’t begin with a tab or space with a search like: 

/ f(space)(tab)]/ 


Within a character class, the caret has a special meaning only if it occurs at 
the beginning. Verify that: 

rev 

finds a ljne that doesn’t begin with a caret. 


A. 5.7 Ampersand: & 

To save entering, the ampersand (&) can be used in substitutions to signify 
the string of text that was found on the left side of a substitute command. 
Suppose you have the line: 

Now is the time 

and you want to make it: 

Now is the best time 

You can enter: 

s/the/thebest/ 

It’s unnecessary to repeat the word “the.” The ampersand (&) eliminates 
this repetition. On the right side of a substitution, the ampersand means 
“whatever was just matched” so you can enter: 

s/the/&best/ 
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and the ampersand will stand for “the.” This isn’t much of a saving if the 
thing matched is just “the” but if the match is very long, or if it is something 
like “ which matches a lot of text, you can save some tedious entering. 
There is also much less chance of making an entering error in the replace- 
ment text. For example, to put parentheses in a line, regardless of its 
length, enter: 

s /.*/(&)/ 


The ampersand can occur more than once on the right side. For example: 

s/the/&best and & worst/ 
makes: 

Now is the best and the worst time 

and: 

s/. */&?&!!/ 

converts the original line into : 

Now is the time? Now is the time! ! 


To get a literal ampersand, use the backslash to turn off the special mean- 
ing. For example: 

s/ ampersand/\&/ 

converts the word into the symbol. The ampersand is not special on the 
left side of a substitute command, only on the right side. 


A. 5. 8 Substituting New Lines 

ed provides a facility for splitting a single line into two or more shorter lines 
by “substituting in a newline.” For example, suppose a line has become 
unmanageably long because of editing. If it looks like: 

....text xy text 

you can break it between the “x” and the “y” like this: 
s/xy/x\ 

y/ 
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This is actually a single command, although it is entered on two lines. 
Because the backslash (\) turns off special meanings, a backslash at the 
end of a line makes the newline there no longer special. 

You can, in fact, make a single line into several lines with this same 
mechanism. As an example, consider italicizing the word “very” in along 
line by splitting “very” onto a separate line, and preceding it with the for- 
matting command “.I.” Assume the line in question looks like this: 

text a very big text 

The command: 

s/ very /\ 

.I\ 

very\ 

/ 

converts the line into four shorter lines, preceding the word “very” with 
the line “.I” and eliminating the spaces around the “very” at the same time. 

When a new line is substituted in a string, dot is left at the last line created. 


A. 5.9 Joining Lines 

Lines may be joined together, with the j command. Assume that you are 
given the lines: 

Now is 
the time 

Suppose that dot is set to the first line. Then the command: 

j 

joins them together to produce: 

Now is the time 

No blanks are added, which is why a blank was shown at the beginning of 
the second line. 
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All by itself, a j command joins the lines signified by dot and dot~+~l, but 
any contiguous set of lines can be joined. Just specify the starting and end- 
ing line numbers. For example: 

l,$jp 

joins all the lines in a file into one bigline and prints it. 


A. 5. 10 Rearranging a Line: \( and \) 

Recall that is shorthand for whatever was matched by the left side of 
an s command. In much the same way, you can capture separate pieces of 
what was matched. The only difference is that you have to specify on the 
left side just what pieces you’re interested in . 

Suppose that you have a file of lines that consist of names in the form: 

Smith, A. B. 

Jones, C. 

and so on, and you want the initials to precede the name, as in : 

A. B. Smith 
C. Jones 

It is possible to do this with a series of editing commands, but it is tedious 
and error-prone. 

The alternative is to “tag” the pieces of the pattern (in this case, the last 
name, and the initials), then rearrange the pieces. On the left side of a sub- 
stitution, if part of the pattern is enclosed between \( and \), whatever 
matched that part is remembered, and available for use on the right side. 
On the right side, the symbol, “\1” refers to whatever matched the first 
\(. . A) pair; “\2” to the second \(. . A), and so on. 

The command: 

l,$sA([.*]\), *\(.*\)/\2\l/ 

although hard to read, does the job. The first \(.. A), matches the last 
name, which is any string up to the comma; this is referred to on the right 
side with “\1.” The second \(.. A), is whatever follows the comma and any 
spaces, and is referred to as “\2.” 

With any editing sequence this complicated, it is unwise to simply run it 
and hope. The global commands, g and v, provide a way for you to print 
exactly those lines which were affected by the substitute command, and 
thus, verify that it did what you wanted in all cases. 
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A. 6 Speeding Up Editing 

One of the most effective ways to speed up your editing is knowing what 
lines will be affected by a command. If you do not specify the lines it is to 
act on, and on what line you will be positioned (i.e. , the value of dot) when 
a command finishes, your editing speed is slowed. If you can edit without 
specifying unnecessary line numbers, you can save a lot of entering. 

For example, if you issue a search command like: 

/thing/ 

you are left pointing at the next line that contains “thing.” Then no address 
is required with commands like s , to make a substitution on that line, or p, 
to print it, or 1, to list it, or d, to delete it, or a, to append text after it, or c, 
to change it, ori, to insert text before it. 

What happens if there is no occurrence of “thing. ” Dot is unchanged . This 
is also true if the cursor was on the only occurrence of “thing” when you 
issued the command. The same rules hold for searches that use ?...?; the 
only difference is the direction in which you search. 

The delete command, d, leaves dot pointing at the line that followed the 
last deleted line. When the line dollar ($) gets deleted, however, dot points 
at the /few line $. 


The line-changing commands a, c, and i, by default, all affect the current 
line. If you give no line number with them, a appends text after the current 
line, c changes the current line, and i inserts text before the current line. 

The a, c, and i commands behave identically in one respect; when you stop 
appending, changing or inserting, dot points at the last line entered. This is 
exactly what you want when entering and editing on the fly. 

For example, you can enter : 

a 

text 

botch (minor error) 

s/botch/correct/ (fix botched line) 
a 

more text 
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without specifying any line number for the substitute command or for the 
second append command . Or you can enter: 

a 

text 

horrible botch (major error) 

c (replace entire line) 

fixed up line 


Experiment to determine what happens if you add no lines with an a, c, or i 
command. 

The r command reads a file into the text being edited, at the end if you give 
no address, or after the specified line if you do. In either case, dot points at 
the last line read in. Remember that you can even enter: 

Or 

to read a file in at the beginning of the text. (You can also enter Oa or li to 
start adding text at the b eginning. ) 

The w command writes out the entire file. If you precede the command by 
one line number, that line is written out. If you precede it by two line 
numbers, that range of lines is written out. The w command does not 
change dot: the current line remains the same, regardless of what lines are 
written out. This is true even if you enter something like: 

A.AB /,/ \. A E/w abstract 

which involves a context search. 

(Since the w command is so easy to use, you should save what you are edit- 
ing regularly, as you go along just in case the system crashes, or in case you 
accidentally delete what you’re editing.) 

The general rule is simple: you are left sitting on the last line changed; if 
there were no changes, then dot is unchanged. To illustrate, suppose that 
there are three lines in the buffer, and the line given by dot is the middle 
one: 


xl 

x2 

x3 
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Then the command: 

-,+s/x/y/p 

prints the third line, which is the last one changed. But if the three lines 
had been: 

xl 

y2 

y3 

and the same command had been issued while dot pointed at the second 
line, only the first line would be changed and printed, and that is where dot 
would be set. 


A. 6.1 Semicolon: ; 

Searches with /.../ and ?...? start at the current line and move forward or 
backward, respectively, until they either find the pattern, or get back to the 
current line. Sometimes, this is not what you want. Suppose, for example, 
that the buffer contains lines like this: 


ab 


be 


Starting at line 1, you would expect the command: 

/a/,/b/p 

to print all the lines from the “ab” to the “be” inclusive. This is not what 
happens. Both searches (for “a” and for “b” start from the same point, 
and thus, they both find the line that contains “ab.” As a result, a single 
line is printed. Worse, if there had been a line with a “b” in it before the 
“ab” line, then the print command would be in error, since the second line 
number would be less than the first, and it is illegal to try to print lines in 
reverse order. 

This is because the comma separator for line numbers doesn’t set dot as 
each address is processed; each search starts from the same place. In ed, 
the semicolon (;) can be used just like the comma, with the single 
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difference that use of a semicolon forces dot to be set at the time the semi- 
colon is encountered, as the line numbers are being evaluated. In effect, 
the semicolon “moves” dot. Thus, in our example above, the command: 

/a/;/b/p 

prints the range of lines from “ab” to “be” because after the “a” is found, 
dot is set to that line, and then “b” is searched for, starting beyond that 
line. 

This property is most useful in a very simple situation. Suppose you want 
to find the second occurrence of “thing.” You could enter: 

/thing/ 

// 

but this prints the first occurrence as well as the second, and is a nuisance 
when you know very well that it is only the second one you’re interested in. 
The solution is to enter: 

/thing/;// 

This says “find the first occurrence of “thing” set dot to that line, then find 
the second occurrence and print only that”. 

Closely related is searching for the second to last occurrence of something, 
as in: 


?something?;?? 


Finally, bear in mind that if you want to find the first occurrence of some- 
thing in a file, starting at an arbitrary place within the file, it is not sufficient 
to enter: 

l;/thing/ 

because, if “thing” occurs on line 1, it will not be found. The command : 
0;/thing/ 

will work because it starts the search at line 1. This is one of the few places 
where 0 is a legal line numb er . 
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A. 6. 2 Interrupting the editor 

As a final note on what dot gets set to, you should be aware that if you press 
the INTERRUPT key while ed is executing a command, your file is 
restored, as much as possible, to what it was before the command began. 
Naturally, some changes are irrevocable; if you are reading in or writing out 
a file, making substitutions, or deleting lines. These will be stopped in 
some unpredictable state in the middle (which is why it usually is unwise to 
stop them). Dot may or may not be changed. 

If you are using the print command, dot is not changed until the printing is 
done. Thus, if you decide to print until you see an interesting line, and then 
press INTERRUPT, to stop the command, dot will not be set to that line or 
even near it. Dot is left where it was when the p command was started. 


A. 7 Cutting and Pasting with the editor 

This section describes how to manipulate pieces of files, individual lines or 
groups of lines. 


A. 7.1 Inserting One File Into Another 

Suppose you have a file called memo , and you want the file called table to 
be inserted just after a reference to Table 1. That is, in memo, somewhere 
is a line that reads: 

Table 1 shows that . . . 

and the data contained in table has to go there. 

To put table into the correct place in the file edit memo, find “Table 1” and 
add the file table right there: 

ed memo 
/Table If 
response from ed 
.r table 

The critical line is the last one. The r command reads a file ; here you asked 
for it to be read in right after line dot. An r command, without any address, 
adds lines at the end, so it is the same as “$r.” 
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A. 7. 2 Writing Out Part of a File 

The other side of the coin is writing out part of the document you’re edit- 
ing. For example, you may want to split the table from the previous exam- 
ple into a separate file so it can be formatted and tested separately. Sup- 
pose that in the file being edited we have: 

.TS 

[lots of stuff] 

.TE 

which is the way a table is set up for the tbl program. To isolate the table in 
a separate file called table , first find the start of the table (the “.TS” line), 
then write out the interesting part. For example, first enter: 

A.TS / 

This prints out the found line: 

.TS 

Next enter: 

.,/\TE/w table 

and the job is done. Note that you can do it all at once with: 
A.TS/;A.TE/w table 


The point is that the w command can write out a group of lines, instead of 
the whole file. In fact, you can write out a single line if you like; just give 
one line number instead of two. If you have just entered a complicated line 
and you know that it (or something like it) is going to be needed later, then 
save it, do not retype it. 

For example, in the editor, enter: 

a 

lots of stuff 
horrible line 

.w temp 
a 

more stuff 

.rtemp 

a 

more stuff 
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A. 8 Editing Scripts 

If a fairly complicated set of editing operations is to be done on a whole set 
of files, the easiest thing to do is to make up a “script” (i.e. , a file that con- 
tains the operations you want to perform, then apply this script to each file 
in turn). 

For example, suppose you want to change every “Xenix” to “XENIX” and 
every “USA” to “America” in a large number of files. Enter the following 
lines into the file script : 

g/Xenix/ s//XENIX/ g 
g/USA/s//America/g 
w 

q 

Now you can enter: 

ed - filel < script 
ed - file2 < script 


This causes ed to take its commands from the prepared file script. Notice 
that the whole job has to be planned in advance, and that by using the 
XENIX shell command interpreter, you can cycle through a set of files 
automatically. The dash (-) suppresses unwanted messages from ed. 

When preparing editing scripts, you may need to place a period as the only 
character on a line to indicate termination of input from an a or i com- 
mand. This is difficult to do in ed, because the period you type will ter- 
minate input rather than be inserted in the file. Using a backslash to escape 
the period won’t work either. One solution is to create the script using a 
character such as the at-sign (@), to indicate end of input. Then, later, use 
the following command to replace the at-sign with a period : 

s/~@$/./ 
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A. 9 Summary of Commands 

This following is a list of all ed commands. The general form of ed com- 
mands is the command name, preceded by one or two optional line 
numbers and, in the case of e, f, r, and w, followed by a filename. Only one 
command is allowed per line, but a p command may follow any other com- 
mand (except e, f, r, w, and q). 


a Appends, i.e., adds lines to the buffer (at line dot, unless a 

different line is specified). Appending continues until a period 
is entered on a new line. The value of dot is set to the last line 
appended. 

c Changes the specified lines to the new text which follows. The 

new lines are terminated by a period on a new line, as with a. 
If no lines are specified, replace line dot. Dot is set to the last 
line changed. 

d Deletes the lines specified. If none are specified, deletes line 

dot. Dot is set to the first undeleted line following the deleted 
lines unless dollar ($) is deleted, in which case dot is set to dol- 
lar. 

e Edits a new file. Any previous contents of the buffer are 

thrown away, so issue a w command first. 

f Prints the remembered filename. If a name follows f, then the 

remembered name is set to it. 

g The command g/ string / commands executes commands on 

those lines that contain string , which can be any context 
search expression. 

i Inserts lines before specified line (or dot) until a single period 

is typed on a new line. Dot is set to the last line inserted. 

1 Lists lines, making visible nonprinting ASCII characters and 

tabs. Otherwise similar top. 

m Moves lines specified to after the line named after m. Dot is 

set to the last line moved. 

p Prints specified lines. If none are specified, print the line 

specified by dot. A single line number is equivalent to a com- 
mand. A single RETURN prints “.+1” the next line. 

q Quits ed. Your work is not saved unless you first give aw com- 

mand . Give it twice in a row to ab ort edit. 


A -51 



XENIX User’s Guide 


r Reads a file into buffer (at end unless specified elsewhere). 

Dot is set to the last line read . 

s The command “s / string 1 / string2 /” substitutes the pattern 

matched by string 1 with the string specified by string 2 in the 
specified lines. If no lines are specified, the substitution takes 
place only on the line specified by dot. Dot is set to the last 
line in which a substitution took place, which means that if no 
substitution takes place, dot remains unchanged. The s com- 
mand changes only the first occurrence of stringl on a line; to 
change multiple occurrences on a line, enter a g after the final 
slash. 

t Transfers specified lines to the line named after t. Dot is set to 

the last line moved. 

v The command v / string / commands executes commands on 

those lines that donot contain string. 

u Undoes the last substitute command. 

w Writes out the editingbuffer to a file. Dot remains unchanged. 

.= Prints value of dot. (An equal sign by itself prints the value of 
$■) 

Icommand 

The line \cmd- line causes cmd- line to be executed as a XENIX 
command. 


/ string / 

Context search. Searches for next line which contains this 
string of characters and prints it. Dot is set to the line where 
string was found. The search starts at .+1, wraps around from 
$ to 1, and continues to dot, if necessary. 


? stringl 

Context search in reverse direction. Starts search at .-1 , 
scans to 1, wraps around to $. 
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Characters 


! command See escape command (!) 

S! variable, process number 4-15 
$# variable, argument recording 4-14 
SS variable, process number 4-14 
S- variable, execution flags 4-15 
S? variable, command exit status 4-14 
{} command See Braces command ({}) 
"l>cc escape See mail 
~cc escape See mail 
'dead escape See mail 
'editor escape See mail 
'headers escape See mail 
'Message escape See mail 
'message escape See mail 
'print escape See mail 
'quit escape See mail 
'read escape See mail 
"subject escape See mail 
"to escape See mail 
"visual escape See mail 
"write escape See mail 
-a operator 4-37 
-b option 
mail 3-31 

-c option, shell invocation 4-42 
mail 3-31 

-e option, shell procedure 4-35 
-f option, mail 3-9, 3-31 
-i option 

mail 3-10, 3-31, 3-32, 3-41 
shell invocation 4-42 
-k option, shell procedure 4-36 
-m option, mail 3-32 
-n option 

echo command 4-38 
shell procedure 4-36 
-o operator 4-37 
R option 
mail 3-31 
-r option 
mail 3-31 
-s option 

mail, subject specification 3-31 
shell invocation 4-42 
-t option, shell procedure 4-36 
-u option, shell procedure 4-35 
mail 3-31 

-v option, input line printing 4-16 
-x option, command printing 4-16 
. command See Dot command (.) 
vi 2-4 

vi use See vi 
.cshrc file 
C-shell use 7-1 
.login file 


.login file ( continued ) 

C-shell use 7-1 
.logout file 
C-shell use 7-2 
.profile file 
description, use 4-16 
PATH variable setting 4-13 
variable export 4-14 
/ command See vi 
/bin directory 

/usr/bin duplicate determination 4-48 
command search 4-3 
contents 4-35 
name derivation 4-35 
/usr/bin directory 
/bin duplicate determination 4-48 
command search 4-3 
0 command See vi 
: command See Colon command (:) 


A 


a command 
appending See ed 
ed use See ed 
mail 3-13, 3-20, 3-35 
Addition See be 
Alias command See a command 
C-shell use See C-shell 
Ampersand (&) 

and-if operator symbol See And-if operator 

(&&> 

background process 4-21, 4-57 
command list 4-20 
ed use See ed 

interrupt, quit immunity 4-21 
jobs to other computers 4-21 
metacharacter See ed 
off-line printing 4-21 
use restraint 4-21 
And-if operator (&&) 
command list 4-20 
description, use 4-21 
designated 4-57 
Append 

ed procedure See ed 
output append symbol See Output 
Argument 
filename 4-3 
list creation 4-3 
mail commands 3-8 
number checking, S# variable 4-14 
processing 4-18 

redirection argument location 4-9 
shell argument passing 4-18 
substitution sequence 4-19 
test command argument 4-38 
Arithmetic 
See also be 
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Arithmetic (continued) 
expr command effect 4-38 
askcc option See mail 
asksubject option See mail 
Asterisk (*) 
be 

comment convention 5-13, 5-14 
multiplication operator symbol 
5-2, 5-4 

directory name, use avoidance 4-4 
mail 

character matching 3-7 
message saved, header notation 
3-17, 3-18 

metacharacter 4-3, 4-57 
pattern matching See metacharacter 
special shell variable 4-19 
At sign ("), mail 3-31, 3-41 
auto command, be 5-19 
autombox option See mail 
autoprint option See mail 


B 


b command See vi 
Background job 

C-shell use See C- shell 
Background process 
$! variable 4-15 

ampersand (&) operator 4-21, 4-57 
Ctrl-d immunity 4-21 
dial-up line 
Ctrl-d effect 4-21 
nohup command 4-21 
INTERRUPT immunity 4-21 
logout immunity 4-21 
QUIT immunity 4-21 
use restraint 4-21 
Backslash (\) 

C-shell use See C-shell 
Backslash () 
be 

comment convention 5-13, 5-14 
line continuation notation 5-6 
ed See ed 

line continuation notation 4-49 
metacharacter escape 4-4 
quoting 4-58 
BACKSPACE key 
be 5-2 

mail 3-6, 3-11 
be command 
be 

file reading, execution 5-13 
invocation 5-1 
-1 command 5-13 
addition operator 


be command ( continued ) 

addition operator ( continued ) 
evaluation order 5-15 
left to right binding 5-4 
scale 5-6, 5-17 
symbol (+) 5-4 
additive operators 

See also Specific Operator 
left to right binding 5-17 
alphabetic register See storage register 
arctan function 
availability 5-1 
loading procedure 5-13 
array 

auto array 5-19 
characteristics 5-14 
identifier 5-14, 5-20 
name 5-9 

named expression 5-15 
one-dimensional 5-9 
assignment operator 
designated, use 5-18 
evaluation order 5-15 
positioning effect 5-5 
symbol (=) 5-5 
assignment statement 5-12 
asterisk (*) 

comment convention 5-13, 5-14 
multiplication operator symbol 
5-2, 5-4 

auto command 5-19 
auto statement 
built-in statement 5-20 
auto, keyword 5-14 
backslash (\) 

comment convention 5-13, 5-14 
line continuation notation 5-6 
BACKSPACE key 5-2 
bases 5-5 
be command 

file reading, execution 5-13 
invocation 5-1 
be -1 command 5-13 
Bessel function 
availability 5-1 
loading procedure 5-13 
braces ({}) 

compound statement enclosure 5-19 
function body enclosure 5-8 
brackets ([]) 

array identifier 5-14 
auto array 5-19 
subscripted variable 5-9 
break statement 
built-in statement 5-20 
break, keyword 5-14 
built-in statement 5-20 
caret 0, exponentiation operator 
symbol 5-4 
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be command ( continued ) 
command See be command 
comment convention 5-13, 5-14 
compound statement 5-19 
constant 

composition 5-14 
defined 5-15 
construction 
diagram 5-13 
space significance 5-13 
control statements 5-10 
cos function 
availability 5-1 
loading procedure 5-13 
define statement 
built-in statement 5-20 
description, use 5-20 
define, keyword 5-14 
demonstration run 5-1 
description 5-1 
division operator 
left to right binding 5-4, 5-17 
scale 5-7, 5-17 
symbol (/) 5-4 
equal sign (=) 

assignment operator symbol 5-5 
relational operator 5-10, 5-19 
equivalent constructions diagram 5-13 
evaluation sequence 5-2 
exclamation point (!) 

relational operator 5-10, 5-19 
exit 5-2, 5-3 
exponential function 
availability 5-1 
loading procedure 5-13 
exponentiation operator 

right to left binding 5-4, 5-17 
scale 5-7, 5-17 
symbol Q 5-4 
expression 

enclosure 5-15 
evaluation order 5-15 
named expression 5-15 
statement 5-19 
for statement 

break statement effect 5-20 
built-in statement 5-20 
description, use 5-10 
format 5-21 
range execution 5-11 
relational operator 5-18 
for, keyword 5-14 
function call 
defined 5-16 
description 5-16 
evaluation order 5-15 
procedure 5-9 
syntax 5-16 
argument absence 5-9 


be command ( continued ) 
function call (continued) 
array 5-9 

calling See function call 
definition procedure 5-8 
form 5-8 
identifier 5-14 
name 5-8 
parameters 5-8 

return statement See return statement 
termination, return statement 5-21 
variable automatic 5-8 
global storage class 5-19 
greater-than sign (>) 

relational operator 5-10, 5-19 
hexadecimal digit 
ibase 5-5 
obase 5-6 
value 5-14 
ibase 

decimal input setting 5-6 
defined 5-15 
initial setting 5-5 
keyword 5-14 
named expression 5-15 
setting 5-5 
variable 5-7 
identifier 

array See array 
auto statement effect 5-20 
description 5-14 
global 5-19 
local 5-19 

named expression 5-15 
value 5-19 
if statement 
built-in statement 5-20 
description, use 5-10 
format 5-21 
range execution 5-10 
relational operator 5-18 
if, keyword 5-14 
INTERRUPT key 5-2 
introduction 5-1 
invocation 5-1 
keywords designated 5-14 
language features 5-12 
length 

built-in function 5-16 
keyword 5-14 

less-than sign (<), relational operator 5-10, 
5-19 

line continuation notation 5-6 
local storage class 5-19 
log function 
availability 5-1 
loading procedure 5-13 
math function library 
See be -1 command 
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be command ( continued ) 
minus sign (-) 

subtraction operator symbol 5-4 
unary operator symbol 5-4, 5-16 
modulo operator 
left to right binding 5-4, 5-17 
scale 5-7, 5-17 
symbol (%) 5-4 
multiplication operator 
evaluation order 5-15 
left to right binding 5-4, 5-17 
scale 5-7, 5-17 
symbol (*) 5-2, 5-4 
multiplicative operators 
See also Specific Operator 
left to right binding 5-17 
named expression 5-15 
negative number, 

unary minus sign (-) 5-4 
obase 

conversion speed 5-6 
defined 5-15 
description 5-6 
hexadecimal notation 5-6 
initial setting 5-6 
keyword 5-14 
named expression 5-15 
variable 5-7 
operator 

See also Specific Operator 
designated, use 5-4 
parentheses (()) 
expression enclosure 5-15 
function identifier argument enclosure 
5-14 

percentage sign (%), modulo operator 
symbol 5-4 
plus sign (+) 

addition operator symbol 5-4 
unary operator symbol 5-16 
program flow alteration 5-10 
quit command 5-2, 5-3 
quit statement 
be exit 5-21 
built-in statement 5-20 
quit, keyword 5-14 
quoted string statement 5-19 
register See storage register 
relational operator 
designated 5-10, 5-18 
evaluation order 5-15 
RETURN key 5-2 
return statement 
built-in statement 5-20 
description 5-21 
form 5-8 

return, keyword 5-14 
scale command 5-7 
addition operator 5-6, 5-17 


be command (continued) 
scale command 5-7 (continued) 
arc tan function 5-13 
Bessel function 5-13 
built-in function 5-16 
command See scale command 
cos function 5-13 
decimal digit value 5-7 
defined 5-15 
description 5-6 
division operator 5-7, 5-17 
exponential function 5-13 
exponentiation operator 5-7, 5-17 
initial setting 5-7 
keyword 5-14 
length function 5-16 
length maximum 5-6 
log function 5-13 
modulo operator 5-7, 5-17 
multiplication operator 5-7, 5-17 
named expression 5-15 
sin function 5-13 
square root effect 5-7, 5-16 
subtraction operator 5-6, 5-17 
value printing procedure 5-7 
variable 5-7 

semicolon (;), statement separation 
5-3, 5-19 
sin function 
availability 5-1 
loading procedure 5-13 
slash (/), division operator symbol 5-4 
space significance 5-13 
square root 
built-in function 5-16 
keyword 5-14 
result as integer 5-5 
scale procedure 5-7 
sqrt keyword 5-14 
statement 

See also Specific Statement 
entry procedure 5-12 
execution sequence 5-19 
separation methods 5-19 
types designated 5-19 
storage classes 5-19 
storage register 5-5 
subscript 

fractions discarded 5-9 
truncation 5-14 
value limits 5-9 
subscripted variable 
array See array 
description 5-9 
subscript See subscript 
subtraction operator 
left to right binding 5-4 
scale 5-6, 5-17 
symbol (-) 5-4 
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be command ( continued ) 
syntax 5-1 

token composition 5-14 
truncation use when 5-7 
unary operator 
designated 5-16 
evaluation order 5-15 
left to right binding 5-16 
symbol (-) 5-4 
variable 

automatic 5-8, 5-19 
name 5-8 

subscripted See subscripted variable 
while statement 

break statement effect 5-20 
built-in statement 5-20 
description, use 5-10 
execution 5-21 
range execution 5-10 
relational operator 5-18 
while, keyword 5-14 
Bessel function See be 
Binary logical and operator 4-37 
Binary logical or operator 4-37 
BINUNIQ shell procedure 4-48 
BKSP 

vi cursor movement 2-18 
Bourne shell 
TERM variable 2-56 
terminal type 2-56 
Braces ({}) 
be 

compound statement enclosure 5-19 
function body enclosure 5-8 
command grouping 4-27 
pipeline, command list enclosure 4-22 
variable 

conditional substitution 4-41 
enclosure 4-12 
Braces command ({}) 4-43 
Brackets ([ ]) 
ed metacharacter See ed 
Brackets ([]) 
be 

array identifier 5-14 
auto array 5-19 
subscripted variable 5-9 
directory name, use avoidance 4-4 
metacharacter 4-3, 4-57 
pattern matching See metacharacter 
test command, use in lieu of 4-36 
break command 

for command control 4-26 
loop control 4-26 
shell built-in command 4-43 
special shell command 4-32 
while command control 4-26 
Buffer See ed 
Buffers See vi 2-25 


Building a Communication System See uucp 


c 


c command See ed 
C language 
be 

comment convention similarity 5-13 
syntax agreement 5-1 
shell language 4-1 
C shell 

TERM variable 2-56 
terminal type setting 2-56 
C-shell 

-n option 7-21 

-v command line option 7-21 
-x command line option 7-21 
.eshre file use 7-1 
alias placement 7-7 
.login file use 7-1 
.logout file use 7-2 
:e modifier 7-18 
:r modifier 7-18 
alias command 
multiple command use 7-7 
number limitation 7-8 
pipeline use 7-7 
quoting 7-8 
use 7-7, 7-10 

command See alias command 
listing 7-10 
removal 7-12 
ampersand (&) 

background job symbol 7-9 
background job use 7-23 
boolean AND operation implementation 
(&&) 7-15 

if statement, avoidance 7-17 
redirection symbol 7-8 
appending 

noclobber variable effect 7-9 
symbol (>>) 7-9 
argument 

expansion 7-22 
group specification 7-23 
argv variable 

filename expansion prevention 7-16 
script arguments contents 7-12 
arithmetic operations 7-15 
asterisk (*) 

character matching 7-23 
script notation 7-14 
background job 
procedure 7-9 
symbol (&) 7-9 
termination procedure 7-9 
backslash (\) 
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C-shell ( continued ) 

backslash (\) ( continued ) 
if statement use 7-17 
metacharacter cancellation 7-24 
metacharacter escape 7-8 
root parts separation from 
extension 7-23 
boolean AND operation 
implementation 7-15 
boolean OR operation 
implementation 7-15 
braces ({}) 

argument expansion use 7-22 
argument grouping 7-23 
brackets ([]) 

character matching 7-23 
break command 

foreach statement exit 7-19 
loop break 7-16 
while statement exit 7-19 
breaksw command 
switch exit 7-19 
c command 
reuse 7-4 
carat Q 

history substitution use 7-24 
character matching 7-23 
colon (:) 

script modifier 7-18 
substitution modifier use 7-24 
command prompt symbol (%) 7-2 
command substitution 
string modification 7-18 
default argument supply 7-7 
execution status 7-15 
expansion 7-23 
file See script 
history list 7-4 
input supply 7-20 
location determination 7-10 
location recomputation 7-3 
multiple commands See commands, 
multiple 
quoting 7-22 

quoting, replacement 7-23 
read only option 7-21 
reading from file 7-11 
repetition 7-10 
repetition mechanisms 7-6 
separation 7-23, 7-23 
separation symbol (;) 7-8 
similarity, foreach command use 7-21 
simplification 7-7 
substitution symbol 7-24 
termination testing 7-15 
timing 7-11 
transformation 7-7 
commands, multiple 
. alias use 7-7 


C-shell ( continued ) 

commands, multiple ( continued ) 
single job 7-9 

comment metacharacter 7-24 
script use 7-12 
symbol 7-18 
continue command 
loop use 7-16 
diagnostic output 
direction 7-8 

redirection See redirection 
directory 

examination 7-3 
listing 7-2 
disk usage 7-9 
dollar sign ($) 

last argument symbol 7-6 
process number expansion 7-14 
variable substitution symbol 7-13 
variable substitution use 7-24 
du command 7-9 
echo option 7-21 
else-if statement use 7-17 
environment 
printing 7-11 
setting 7-11 
variable removal 7-12 
equal sign (=) 

string comparison (==), (=~) 7-15 
exclamation point (!) 

history list substitution use 7-10 
history mechanism invocation character 
use 7-5 

history substitution use 7-24 
string comparison use (!=), (!“) 7-15 
syntax use 7-4 
execute primitive 7-15 
existence primitive 7-15 
expansion metacharacters 
designated 7-24 
control 7-21 

expression primitives 7-15 
enclosure 7-23 
evaluation 7-15 
extension extraction 7-18 
file overwriting 
prevention 7-4 
procedure 7-4 
appending 7-9 

command content See script 
enquiries 7-15 
filename metacharacters 
designated 7-23 
expansion 7-22 
expansion prevention 7-16 
home directory indication 7-23 
root extraction 7-18 
scratch filename metacharacter 7-24 
foreach command 7-21 
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C-sheil (continued) 
exit 7-19 
script use 7-16 
goto labael 

script cleanup 7-21 
goto statement 7-19 
greater- than sign (>) 

redirection symbol 7-8, 7-24 
history command 7-6 
use 7-10 
history list 7-4 

command substitution 7-10 
contents display 7-10 
history mechanism invocation 
character 7-5 
alias, use 7-7 
use 7-6 

history variable 7-2 

substitution symbol 7-24 
home variable 7-3 
if statement use 7-17 
ignoreeof variable 7-1, 7-3 
input metacharacters designated 7-24 
execution procedure 7-13 
variable substitution See variable 
substitution 
INTERRUPT key 
background job, effect 7-9 
invocation procedure 7-1 
kill command 

background job termination 7-9 
less-than sign (<) 

redirection symbol 7-24 
script inline data supply (<<) 7-20 
logging out 

logout command use 7-1 
procedure 7-2 
shield 7-1 
logout command 
use 7-1, 7-10 
loop 

break 7-16 
input prompt 7-21 
variable use 7-22 
mail program 
invocation 7-2 
mail variable 7-4 
new mail notification 7-1 
metacharacter 
cancellation 7-24 
expansion metacharacter 7-24 
filename metacharacter 7-23 
input metacharacter 7-24 
output metacharacter 7-24 
quotation metacharacter 7-24 
substitution metacharacter 7-24 
syntactatic metacharacter 7-23 
metaxyntax 

exclamation point (!) use 7-4 


C- shell (continued) 
minus sign (-) 
option prefix 7-24 
modifiers 7-18 
n key 

script error absence 7-15 
script notation 7-14 
new program access 7-3 
noclobber variable 7-4 
appending procedure 7-9 
redirection symbols 7-8 
noglob variable 

filename expansion prevention 7-16 
number sign (#) 

C-shell comment symbol 7-12, 7-21 
C-shell comment use 7-18, 7-24 
scratch filename use 7-24 
onintr label 
script cleanup 7-21 
option 

metacharacter 7-24 

output metacharacters designated 7-24 
diagnostic output 

See diagnostic output 
redirection See redirection 
parentheses (()) 

expression enclosure 7-23 
path variable 7-2 
pathname 

component separation 7-23 
percentage sign (%) 

command prompt symbol 7-2 
pipe symbol (|) 

boolean OR operation implementation (||) 
7-15 

command separation 7-23 
if statement, avoidance 7-17 
redirection symbol 7-8 
pipeline 
alias, use 7-7 

primitives See expression primitives 
printenv 

environment printing 7-11 
process number expansion 
notation 7-14 
listing 7-9 

prompt variable 7-10 
ps command 

process number listing 7-9 
question mark (?) 
character matching 7-23 
loop input prompt 7-21 
QUIT signal 

background job, effect 7-9 
quotation mark, back (') 
command substitution use 7-24 
quotation mark, double (") 7-21 
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C-shell ( continued ) 
quotation mark, double (") 7-21 
(continued) 

metacharacters cancellation 7-24 
quotation mark, single (’) 
quoted string, effect 7-21 
quotation mark, single(') 

metacharacters cancellation 7-24 
quotation marks, back (") 
command quoting 7-22 
quotation marks, double (") 
string quoting 7-22 
quotation marks, single (~) 
alias quoting 7-8 
script inline data quoting 7-20 
quotation metacharacters 
designated 7-24 
read primitive 7-15 
redirection 

diagnostic output 7-8 
output 7-8 

symbols designated 7-24 
rehash command 7-3 
command location 

recomputation 7-10 
repeat command 
command repetition 7-10 
root part 

extension, separation 7-23 
script 

clean up 7-20 
colon (:) modifier 7-18 
command input 7-20 
comment required 7-21 
description 7-12 
example 7-16 
execution 7-12 
exit 7-21 

inline data supply 7-20 
interpretation 7-12 
interruption catching 7-20 
metanotation for inline data 7-20 
modifiers 7-18 
notations 7-14 
c-shell 
script 

range 7-15 
C-shell 
script 

variable substitution See variable 
substitution 
semicolon (;) 

command separation 7-23 
command separation’ 7-8 
if statement, avoidance 7-17 
set command 
variable listing 7-2 
variable value assignment 7-2 


C-shell ( continued ) 
setenv command 
environment setting 7-11 
slash (/) 

pathname component separation 7- 
source command 
command reading 7-11 
status variable 7-16 
string 

comparison 7-15 
quoting 7-22 

substitution metacharacters 
designated 7-24 
switch statement 
exit 7-19 
form 7-19 

syntactic metacharacters 
designated 7-23 
then statement use 7-17 
tilde (~) 

home directory indication 7-23 
string comparision (=~), (!~) 7-15 
time command 
command timing 7-11 
time variable 7-2 
unalias command 
alias removal 7-12 
unset command 
variable removal 7-12 
unsetenv command 
variable removal from 
environment 7-12 
un setting procedure 7-4 
variable substitution 
procedure 7-13 
component access 7-14 
component access notations 7-13 
definition removal 7-12 
environment variable setting 7-11 
expansion 7-13, 7-22 
listing 7-2 
loop use 7-22 

removal from environment 7-12 
See also Specific Variable 
setting procedure 7-3 
substitution metacharacter 7-24 
substitution See variable substitution 
use 7-2 

value assignment 7-2 
value assignment check 7-13 
verbose option 7-21 
while statement 
exit 7-19 
form 7-19 
write primitive 7-15 
> & symbol 
redirection use 7-8 
| & symbol 
redirection use 7-8 
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Calculation 
See also be 

Calculator functions See be 
Calendar reminder service 3-32 
Caret 0 

be, exponentiation operator 
symbol 5-4 
ed use See ed 

mail, first message specification 3-7, 3-16, 
3-34 

case command 

description, use 4-23 
exit status 4-24 
redirection 4-28 
shell built-in command 4-43 
Case delimiter symbol (;;) 4-57 
Case-part 4-56 
cat command 
ed See ed 

cd arg command 4-32 
cd command 

directory change 4-15 
mail 3-22, 3-35 
parentheses use 4-15 
time consumption minimization 4-46 
CDPATH variable 4-13 
Character class See ed 
chron option See mail 
Colon (:) 

command See Colon command (:) 
mail 

command escape 3-26 
network mail 3-13 
PATH variable use 4-13 
variable conditional substitution 4-42 
vi use See vi 
Colon command (:) 
description 4-32 
shell built-in command 4-43 
special shell command 4-32 
Command line 
execution 4-20 
options 

See also Specific Option 
designated 4-42 
pipeline, use in 4-22 
rescan 4-20 

scanning sequence 4-19 
substitution 4-9 
Command list 

case command, execution 4-24 
defined 4-20 

for command, execution 4-25 
grammar 4-56 
defined 4-20 
delimiter See ed 
ed commands See ed 
enclosure in parentheses (()), 
effect 4-44 


Command list ( continued ) 
environment 4-17 
execution 4-2 
time 4-43 

exit status See Exit status 
grammar 4-56 
grouping 

exit status 4-28 
parentheses (()) use 4-57 
procedure 4-27 

WRITEMALL shell procedure 4-55 
keyword parameter 4-17 
line See Command line 
list See Command list 
mail commands summary 3-34 
multiple commands entry 4-9 
output substitution symbol 4-58 
private command name 4-3 
public command name 4-3 
search 

PATH variable 4-13 
process 4-46 

separation symbol (;) 4-57 
shell, built-in commands 
designated 4-43 
simple command 
defined 4-2, 4-20 
grammar 4-56 

slash (/) beginning, effect 4-3 
special shell commands See Shell 
special shell commands See Specific Special 
Command 
substitution 

back quotation marks (“) 4-4 
double quotation marks (") 4-5 
procedure 4-9 
redirection argument 4-6 
vi commands See vi 
Communication See mail 
compose escapes 3-1 
Compose escapes See mail 
continue command 

for command control 4-26 
shell built-in command 4-43 
special shell command 4-32 
until command control 4-26 
while command control 4-26 
Control command 

See also Specific Control Command 
redirection 4-28 
Copy command See vi 
COPYPAIRS shell procedure 4-48 
COPYTO shell procedure 4-49 
esh command 

C-shell invocation 7-1 
Ctrl-d 

background process immunity 4-21 
be exit 5-2, 5-3 
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Ctrl-d ( continued ) 
mail 

message sending 3-3, 3-10 
reply message termination 3-12, 3-19 
shell exit 3-22, 4-27 
vi scroll 2-21 
Ctrl-f 

vi scroll 2-21 
Ctrl-g 

vi See vi 2-11 
Ctrl-h, mail 3-6 
Ctrl-u 

mail, line killing 3-6, 3-11 
vi scroll 2-21 
Current line 
See vi 

Cursor movement 
vi See vi 

Cutting and pasting procedure See ed 


D 


D command See vi 
d command 
ed use See ed 
d$ command See vi 
dO command See vi 
dd command See vi 
Delete buffer See vi 
Deletion 

vi procedure See vi 
Delimiter See ed 
Diagnostic output See Output 
dial See also uucp 

Dial-up line See Background process 
dial 

and uucp 6-31 
Digit grammar 4-56 
Directory 

C-shell use See C-shell 
listing 7-2 

name, metacharacter avoidance 4-4 
search 

optimum order 4-46 
PATH variable 4-46 
sequence change 4-3 
size effect 4-47 
time consumption 4-46 
size consideration 4-47 
DISTINCT1 shell procedure 4-49 
Division See be 
Dollar sign ($) 
ed use See ed 

mail, final message specification 3-7, 3-16, 
3-34 

positional parameter prefix 4-10, 4-11 
PS1 variable default value 4-13 


Dollar sign ($) (continued) 
variable prefix 4-11 
vi See vi 
Dot (.) 

command See Dot command (.) 
ed use See ed 
mail, current message 
specification 3-7, 3-15 
vi use See vi 
Dot command (.) 
description, use 4-29 
shell built-in command 4-43 
shell procedure alternate 4-35 
special shell command 4-32 
Dot option See mail 
dp command See mail 
DRAFT shell procedure 4-50 
dw command See vi 
dw command See vi 2-29 


E 


e command 
ed use See ed 
mail 3-7, 3-35 
mailR 3-21 
echo command 

-n option effect 4-38 
description, use 4-38 
mail 3-35 
syntax 4-38 
ed 

a command 
append A-3, A-51 
backslash (\) characteristics A-34 
dot (.) setting A-44, A-51 
global combination A -26 
input termination A-4, A-32 
abortion, q command A-51 
address arithmetic A-9 
ampersand (&) 
literal A-41 
metacharacter A-40 
substitution A-40 
append See a command 
asterisk (*), metacharacter 
A-29, A-36 
at sign ("), script A-50 
backslash (\) 
a command A-34 
c command A-34 
g command A -25 
i command A-34 
line folding A-26 
literal A -33 

metacharacter A-29, A-32 
metacharacter escape A-32, A-33, A-41, 
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ed ( continued ) 
backslash (\) ( continued ) 

A-42 

multiline construction A-26 
number string A-26 
v command A-25 
backspace printing A-26 
brackets ([]) 

character class A-39 
metacharacter A-29, A-39 
buffer 

description A-3 
writing to file See w command 
c command 

backslash (\) characteristics A-34 
dot (.) setting A-20, A-44, A-51 
global combination A-26 
input termination A-20 
line change A-20, A-51 
caret Q 

character class A-39 
line beginning notation A-36 
metacharacter A-29, A-36 
cat command A-6 
change command See c command 
character class A-39 
deletion at line beginning A-39 
command 

See also Specific Command 
combinations A-25 
delimiter character A-33 
description A-4 

editing command See e command 
form A-51 

INTERRUPT key effect A-48 
listing A-51 

multicommand line restrictions A-15 
summary A-51 
context search See search 
current line See dot (.) 
cutting and pasting 

move command See m command 
procedures A-48 
d command 
deletion A-13, A-51 
dot (.) setting A-44, A-51 
deletion See d command 
delimiter 

character choice A-33 
description A-l 
dollar sign ($) 

last line notation A-8, A-13, A-35 
line end notation A-34, A-35 
metacharacter A-29, A-34 
multiple functions A-35 
dot (.) 

current line notation A-9 
description A- 11 
determination A-44 


ed (continued) 
dot (.) ( continued ) 
search setting A- 17, A-52 
substitution setting A -14 
symbol (.) A-ll, A-31 
value determination A- 12, A-52 
duplication See t command 
e command A-6, A-51 
edit See e command 
entry A-3 
equals sign (=) 

dot value printing (.=) A-12, A-52 
last line value printing A-52 
escape command (!) A-28, A-52 
exclamation point (!), 

escape command A-28 
exit See q command 
f command A-7, A-51 
file 

insertion into another file A-48 
writing out A -49 
filename 
change A-7 
recovery A-7 

remembered filename printing 
A-7, A-51 
folding A-26 
g command 

a command combination A-26 
backslash (\) use A-25 
c command combination A-26 
command combinations A-24, A-25 
dot (.) setting A-24 
i command combination A-26 
line number specifications A-25 
multiline construction A-26 
s command combination A-24, A-52 
search, command execution 
A-23, A-51 

substitution A- 16, A-29 
trailing g A-29 

global command See g command 
global command See v command 
greater-than sign (>), 
tab notation A-26 
grep command A-29 
hyphen (-), character class A-39 
i command 

backslash (\) characteristics A-34 
dot (.) setting A-21, A-44, A-51 
global combination A-26 
input termination A -32 
insertion A-20, A-51 
Ed 

in-line input scripts 4-51 
ed 

input 

termination A-4, A-20, A-32 
insert command See i command 
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ed ( continued ) 

INTERRUPT key 
command execution effect A-48 
dot (.) setting A-48 
print stopping A-9 
introduction A-l 
invocation A-3 
j command, line joining A-42 
k command, line marking A-27 
1 command 
folding A-26 
line listing A-26, A-51 
nondisplay character printing A-26 
number string A-26 
s command combination A-30 
less-than sign (<) 

backspace notation A-26 
line beginning 

character deletion A-39 
notation A-36 
line end 
notation A-34 
line number 

0 as line number A-47 
combinations A-9 
summary A-51 
beginning See line beginning 
break See splitting 
folding A-26 
joining A-42 
marking A-27 
moving See m command 
number See line number 
rearrangement A-43 
splitting A-41 
writing out A -49 
list See 1 command 
m command 

dot (.) setting A-23, A-51 
line moving A-22, A-51 
warning A-23 
Ed 

mail system See mail 
ed 

marking See k command 
metacharacter 

ampersand (&) A-40 
asterisk (*) A-29, A-36 
backslash (\) A-29, A-32 
brackets ([]) A-29, A-39 
caret ( ) A-29, A-36 
character class A-39 
combination A-36 
dollar sign ($) A-29, A-34 
escape A-33, A-41 
period (.) A-29, A-30 
search A-39 
slash (/) A-29 
star (*) A-29, A-36 


ed (continued) 

minus sign (-), address arithmetic A-9 
move 

command See m command 
line marking A-27 

multicommand line restrictions A-15 
new line 

substitution A-41 

nondisplay character printing A-26 
p command 
dot (.) setting A-48 
multicommand line A-15 
printing A-8, A-51 
s command combination A-30 
pattern search See search 
period (.) 

a command input termination 
A-4, A-32 

c command input termination A-20 
character substitution A-30 
dot symbol See Dot (.) 
i command input termination A-32 
literal A-32 

metacharacter A-29, A-30 
s command, effect A-30 
script problems A-50 
search problems A-29 
troff command prefix A-23 
plus sign (+), address arithmetic A-9 
print 

command See p command 
line folding A-26 
RETURN key effect A- 12 
stopping A-9 
q command 
abortion use A-51 
quit session A-5, A-51 
w command combination A-51 
question mark (?) 
exit warning A-3 
search error message (?) A-17 
search repetition (??) A-19 
search, reverse direction (? ?) 

A-17, A-52 
write warning A-5 
quit See q command 
quotation marks, single (”) 
line marking A-27 
r command 

dot (.) setting A-45, A-52 
file insertion A-48 
positioning without address A-48 
read file A-7, A-52 
reading See r command 
regular expression 
description A-29 
metacharacter list A-29 
RETURN key, printing A-51 
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ed ( continued ) 
s command 
ampersand (&) A-40 
character match A-30 
description, use A-14, A-52 
dot (.) setting A-15, A-44, A-52 
g command combination 
A-16, A-24, A-52 
1 command combination A-30 
line number A-30 
new line A-41 

p command combination A-30 
search combination A-18 
text removal A-15 
trailing g A-29 
undoing A -27 

v command combination A-24 
script A-50, A-50 
search 

dot (.) setting A-52 
error message (?) A- 17 
forward search (/ /) A-16, A-52 
global search See g command 
global search See v command 
metacharacter problems A-29 
next occurrence description A-17 
procedure A-16 
repetition (//), (??) A- 19 
reverse direction (? ?) A-17 
separator A -46 

substitution combination A-18 
sed command A-29 
semicolon (;) 

dot (.) setting A-47 
search separator A -46 
shell 

escape See escape command (!) 
slash (/) 
delimiter A-33 
literal A-33 
metacharacter A-29 
search forward (/ /) A-16, A-52 
search repetition (//) A-19 
special character See metacharacter 
spelling correction See s command 
star (*), metacharacter A-29, A-36 
substitution 

command See s command 
t command 

dot (.) setting A-52 
transfer line A-28, A-52 
tab printing A-26 
tbl command A-49 
termination See q command 
text 

removal See s command 
saving A -5 

transfer See t command 
troff command printing A-23 


ed (continued) 

typing error correction 
See s command 
u command 

undo A-27, A-52 
undo See u command 
v command 

a command combination A-26 
backslash (\) use A-25 
c command combination A-26 
command combinations A-24, 

A-25, A-26 
dot (.) setting A-24 
global search, substitute A-23, A-52 
i command combination A-26 
line number specifications A-25 
s command combination A-24 
w command 

description, use A-5 
dot (.) setting A-45, A-52 
e command combination A-51 
file write out A-49 
frequent use advantages A-45 
line write out A-49 
write out A-5, A-5, A-49, A-52 
write out 

command See w command 
warning A-5 

ED FIND shell procedure 4-51 
Editor See ed 

EDITOR string, mail 3-29, 3-41 
EDLAST shell procedure 4-51 
elif clause See if command 
else clause See if command 
Else-part grammar 4-56 
Empty grammar 4-56 
Equal sign (=) 
be 

assignment operator symbol 5-5 
relational operator 5-10, 5-19 
ed use See ed 

mail, message number printing 
3-16, 3-34 
variable 

conditional substitution 4-41 
string value assignment 4-11 
errdirect file 4-30 
Error output redirection 4-40 
ESCAPE key 
vi See vi 

Escape string, mail 3-30, 3-41 
eval command 

command line rescan 4-20 
shell built-in command 4-43 
ex, ed similarity A-l 
Exclamation point (!) 
be, relational operator 5-10, 5-19 
C-shell use See C-shell 
ed use See ed 
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Exclamation point (!) (continued) 
mail 

network mail 3-13 
shell command execution 
3-21, 3-26, 3-34 
unary negation operator 4-37 
vi See vi 

exec arg command 4-32 
exec command 4-43 
Exit code See $? variable 
exit command 

shell built-in command 4-43 
shell exit 4-27 
special shell command 4-32 
Exit status 
$? variable 4-14 
case command 4-24 
cd arg command 4-32 
colon command (:) 4-32 
command grouping 4-28 
false command 4-39 
if command 4-23 
read command 4-33 
true command 4-39 
until command 4-25 
wait command 4-33 
while command 4-25 
export command 
shell built-in command 4-43 
variable 

example 4-14 
listing 4-17 
setting 4-17 
expr command 4-38 


F 


F command, mail 3-12, 3-20, 3-35 
f command 
ed use See ed 

mail 3-11, 3-12, 3-20, 3-35 
false command 4-39 
fi command 
if command end 4-22 
mail 3-35 
File descriptor 
description, use 4-6 
redirection 4-7, 4-40 
creating 
with vi 2-2 
creation 

MKFELES shell procedure 4-53 
descriptor See File descriptor 
grammar 4-56 
mail system files See mail 
pattern search See ed 
pattern search See grep command 


File descriptor (continued) 
pipe interchange 4-50 
shell procedure creation 4-34 
textual contents determination 4-55 
variable file creation See Variable 
Filename 
argument 4-3 
ed See ed 
Filter 

description 4-7 
order consideration 4-45 
Flag See Option 
for command 

break command effect 4-26 
continue command effect 4-26 
description, use 4-25 
redirection 4-28 
shell built-in command 4-43 
for loop, argument processing 4-18 
fork command 4-44 
FSPLIT shell procedure 4-52 


G 


g command See ed 
G command 
vi See vi 
Global 

ed use See ed 
variable check 4-36 
goto command 
See G command 2-5 
Greater-than sign (>) 
be, relational operator 5-10, 5-19 
PS2 variable default value 4-13 
redirection symbol 4-57 
grep command 
ed See ed 


H 


h command 
mail 3-9, 3-16, 3-35 
H command 
vi use See vi 
h command 
vi use See vi 
H flag, mail 3-17 
headers command See mail 
help 
vsh 8-2 

history command 
C-shell use 7-6 
ho command See mail 
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HOME variable 
conditional substitution 4-42 
description 4-12 


i 


i command See ed 
if command 

COPYTO shell procedure 4-49 
description, use 4-22 
exit status 4-23 
fi command required 4-23 
multiple testing procedure 4-22 
nesting 4-23 
redirection 4-28 
shell built-in command 4-43 
test command 4-36 
IFS variable 4-12 
ignore option See mail 
ignorecase option See vi 2-39 
In-line input document See Input 
Input 
ed See ed 
grammar 4-56 
in-line input 
document 4-39 

EDFIND shell procedure 4-51 
standard input file 4-6 
Insert mode See vi 
Insertion See ed 
Internal field separator 
shell scanning sequence 4-19 
specificaiton by IFS variable 4-12 
INTERRUPT key 
background process immunity 4-21 
be 5-2 

ed use See ed 
mail 

askee switch 3-28 
message abortion 3-11, 3-29 
Interrupt 

handling methods 4-29 
key See INTERRUPT key 
Invocation flag See Option 
Item grammar 4-56 


J 


j command See ed 
vi use See vi 


j command See ed ( continued ) 


K 


k command See ed 
vi use See vi 
Keyword parameter 
-k option effect 4-36 
description 4-17 
kill command 
C-shell use See C-shell 


L 


1 command 
ed use See ed 
mail 3-19, 3-36 
L command 
vi use See vi 
1 command 
vi use See vi 
Less-than sign (<) 
be, relational operator 5-10, 5-19 
redirection symbol 4-57 
line command 

shell variable value assignment 4-9 
Line-oriented commands See vi 2-12 
beginning See ed 
writing out See ed 
linenumber option See vi 
list command 
mail 3-36 
list option See vi 

LIST HELDS shell procedure 4-52 
Logging out 

background process immunity 4-21 
shell termination 4-27 
Login directory 
defined 4-12 
logout command 
C-shell use 7-1 
Looping 

break command 4-26 
continue command 4-26 
control 4-26 
expr command 4-39 
false command 4-39 
for command 4-25 
iteration counting procedure 4-39 
time consumption 4-43 
true command 4-39 
unconditional loop 
implementation 4-39 
until command 4-25 
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Looping ( continued ) 
while command 4-24 
while loop 4-48 
lp command 
mail 

-m option 3-32 
Ipr command 
mail 

message printing 3-19, 3-36 
Is command 

echo * use in lieu of 4-38 


M 


m command 
ed See ed 
mail 3-19, 3-36 
M flag See mail 
magic option See vi 
mail command See mail 
MAIL variable 4-12 
mail 

-f option 3-9, 3-31 
-i option 3-10, 3-31, 3-32, 3-41 
-m option 3-32 
-s option 3-31 
.mailrc file 
alias contents 3-20 
distribution list creation 3-13 
example 3-27 
options setting 3-14 
set command 3-21 
unset command 3-21 
? command See help command (?) 
a command See alias 
accumulation 3-32 
Alias 3-34 
alias 

a command 3-13, 3-20, 3-35 
display 3-13 
network mail 3-14 
personal 3-13, 3-27 
R command 3-13 i 
system-wide 3-27 
askcc option 3-14, 3-28, 3-40 
asksubject option 3-27, 3-40 
asterisk (*) 

character matching 3-7 
message saved, 

header notation 3-17, 3-18 
at sign ("), 

ignore switch echo 3-31, 3-41 
autombox option 

description, use 3-30, 3-40 
effect 3-18 
H flag 3-17 
ho command 3-19 


mail (continued) 

autoprint option 3-28, 3-40 
BACKSPACE key 3-6, 3-11 
Bcc field See blind carbon copy field 
blind carbon copy field 
description 3-5 
editing 3-24, 3-24 
escape See ~bcc escape 
box See mailbox 
Mail 
C-shell 

new mail notification 7-1 

mail 

carbon copy field 

additions prompt 3-14 
blind See blind carbon copy field 
description 3-5 
display 3-4 
editing 3-24 
escape See ~c escape 
escape See ~cc escape 
option See askcc option 
R command effect 3-12 
caret Q, first message specification 
3-7, 3-16, 3-34 
cc field See carbon copy field 
cd command 3-22, 3-35 
chron option 3-28, 3-40 
colon (:) 

escape See command escape (~:) 
network mail 3-13 
command escape (':) 3-26, 3-38 
command line options 3-31 
command mode 
description, use 3-7 
help command 3-14 
options setting 3-14 
See also Specific Command 
descriptions 3-14 
escape See command escape (“:) 
invocation 3-14 
summary 3-34 
syntax 3-8 

compose escape (~!) 3-38 
compose escape (~[) 3-38 
compose escapes 

See also Specific Escape 
compose mode exit 3-6 
edit mode entry 3-7 
heading escapes 3-23 
listing 3-2, 3-12 
m command 3-19 
reply 3-19 
summary 3-38 
tilde C) component 3-11 
compose mode 
compose escapes 

See compose escapes 
description, use 3-6 
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mail ( continued ) 
compose mode ( continued ) 
edit mode entry 3-7 
entry from command mode 3-11 
entry from shell 3-11 
tilde escapes See compose escapes 
concepts 3-4 
Ctrl-d 

message reply 3-12, 3-19 
message sending 3-10 
Ctrl-h, backspace 3-6 
Ctrl-u, line killing 3-6, 3-11 
d command 3-4, 3-7, 3-11, 3-17, 3-35 
dead. letter file 

escape See ~d escape 
no save switch effect 3-29 
undelivered message receipt 3-10 
deletion See message 
distribution list creation 3-13 
dollar sign ($), final message 
specification 3-7, 3-16, 3-34 
dot (.), current message 
specification 3-7, 3-15 
dot option 3-28, 3-40 
dp command 3-17, 3-35 
e command 3-21, 3-35 
echo command 3-35 
editor escape See ~e escape 
editor escape See ~v escape 
EDITOR string 3-29, 3-41 
entry 3-9 

equal sign (=), message number 
printing 3-16, 3-34 
escape string 3-30, 3-41 
exclamation point (!) 
network mail 3-13 
shell command execution 
3-21, 3-26, 3-34 
execmail 3-28 
exit 

q command 3-4, 3-9, 3-18, 3-36 
x command 3-18, 3-35 
f command 3-11 
F command 3-12 
f command 3-12 
F command 3-20 
f command 3-20 
F command 3-35 
f command 3-35 
fi command 3-35 
file switch See -f option 
files designated 3-33 
forwarding 

messages not deleted 3-18 
procedure See F command 
procedure See f command 
h command 3-9, 3-16, 3-35 
H flag, message saving 3-17 


mail (continued) 
header 

characteristics 3-17 
command See h command 
defined 3-8 
display 3-3, 3-8, 3-9 
listing 3-35 
windows 3-8, 3-16 
heading 

compose escapes 3-23 
composition 3-5 
help command (?) 3-3, 3-14 
help escape ("?) 3-12, 3-23, 3-38 
ho command 
description 3-19 
H flag 3-17 
message saving 3-36 
hold command See ho command 
ignore switch See -i option 
INTERRUPT key 
message abortion 3-11, 3-29 
recipient list 3-28 
introduction 3-1 
invocation, -i option 3-10 
1 command 3-19, 3-36 
line killing 3-6, 3-11 
list command 3-36 
Ip command 
-m option 3-32 
lpr command 

message printing 3-19, 3-36 
m command 3-19, 3-36 
M flag, message saving 3-17 
mail command 

command mode entry 3-7, 3-9 
compose mode entry 3-11 
help 3-3 

message reading 3-3, 3-10 
message sending 3-2, 3-36 
mail escapes See ~M escape 
mail escapes See ~m escape 
mailbox See mailbox 
mb command 3-19, 3-36 
mbox command See mb command 
mchron option 3-41 
message number 
command 3-16, 3-34 
message printing 3-11 
printing 3-16, 3-34 
types 3-7 
message-list 

argument, multiple messages 3-12 

composition 3-7 

full message-list description 3-8 

abortion 3-10, 3-11, 3-29 

advancement 3-11, 3-34 

body 3-5 

composition 3-5 

deletion 3-4, 3-7, 3-11, 3-17, 3-35 
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mail ( continued ) 
message-list ( continued ) 
deletion undoing 3-17 
description 3-5 

editing 3-11, 3-21, 3-21, 3-31, 3-35 

file inclusion 3-25 

forwarding See forwarding 

header See header 

heading See heading 

insertion into new message 3-25 

list See message-list 

listing 3-3 

number See message number 
printing See printing 
range description 3-7 
reading 3-3, 3-10 
reading into file 3-9 
reply See reply 
saving See saving 
sending See sending 
size 3-22, 3-37 
specification 3-12 
undeletion 3-11 
metacharacters 3-7, 3-15 
metoo option 3-29, 3-41 
minus sign (-), 
message advancement 3-34 
network mail 3-13 
noisy phone line 3-10 
nosave option 3-29, 3-41 
number command 
See message number 
options 

See also Specific Option 
command line options 3-31 
setting 3-14 
summary 3-40 
switch option setting 3-21 
organization 3-32 
p command 

message printing 3-3, 3-7, 3-14, 3-36 
syntax 3-8 
page option 3-30 
period (.), dot use See dot (.) 
phone line noise 3-10 
plus sign (+), 

message advancement 3-34 
printing 

command See lpr command 
command See p command 
escape See ~p escape 
lineprinter See lpr command 
procedure 3-7, 3-11 
top five lines See t command 
programs designated 3-33 
prompt 3-3 
q command 

exit 3-4, 3-9, 3-18, 3-36 
message abortion 3-29 


mail (continued) 

question mark (?) 

command summary printing 3-34 
compose escape help 
See help escape ('?) 
help command 3-14 
quiet option 3-29, 3-41 
R command 
alias effect 3-13 
compose mode entry 3-11 
r command 

compose mode entry 3-11 
message reply 3-11 
R command 

message reply 3-12 
r command 
message reply 3-12 
R command 

message reply 3-19 
r command 

message reply 3-19 
R command 

message reply 3-20 
r command 
message reply 3-36 
R command 
message reply 3-37 
read escape See ~d escape 
read escape See ~r escape 
recipient list, name addition 3-23 
record string 3-30, 3-41 
reminder service 3-32 
Reply command See R command 
reply command See r command 
return receipt request field 3-5 
s command 
flag 3-17 

message saving 3-18, 3-37 
system mailbox, message deletion 3-18 
saving 

asterisk (*) notation 3-18 
automatic 3-17 
command See s command 
flag 3-17 

ho command 3-36 
M flag 3-17 
message display 3-4 
s command 3-18, 3-37 
system mailbox 3-9 
w command 3-18, 3-38 
se command See set command 
sending 

cancellation impossible 3-3 
multiple recipients 3-10 
network mail 3-13 
procedure 3-10 
to self 3-2 

session abortion 3-11 
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mail ( continued ) 
set command 
description, use 3-21, 3-37 
option control 3-40 
set options defined 3-27 
sh command 3-21, 3-37 
shell commands 3-21 
shell escape (“!) 3-26 
shell escape (“() 3-26 
SHELL string 3-29, 3-41 
si command 3-22, 3-37 
so command 3-22, 3-37 
source command See so command 
special characters See metacharacters 
startup file 3-27 
string option 
setting 3-21 
summary 3-40 

subject escape See “s escape 
subject field 3-4, 3-5 
subject switch See -s option 
subject switch See asksubject option 
switch See Option 
system composition 3-33 
system mailbox, message retention 3-9 
t command 

message top printing 3-12, 3-16, 3-37 
toplines option 3-16 
tilde escapes See compose escapes 
tilde quote escape (“”) 3-27, 3-38 
to field 

mandatory 3-5 
R command effect 3-12 
top command See t command 
toplines option 3-41 
toplines string 3-30 
u command 3-8, 3-11, 3-17, 3-37 
undeletion See u command 
unset command 

description, use 3-21, 3-37 
option control 3-40 
v command 3-7, 3-21, 3-37 
Mail 

variable See MAIL variable 
mail 

vertical bar (|) escape 
See shell escape (“|) 

VISUAL string 3-29, 3-41 
w command 

message write out 3-18, 3-38 
system mailbox, message deletion 3-18 
write escape See ~w escape 
write out See w command 
x command 
exit 3-18, 3-35 
session abortion 3-11 
-b option 3-31 
-c option 3-31 
-R option 3-31 


mail ( continued ) 

-r option 3-31 
-u option 3-31 
"! See shell escape (“!) 

“: See command escape (“:) 

“? See help escape (“?) 

“b escape 3-24 
“bcc escape 3-39 
“c escape 3-24 
“cc escape 3-39 
~d escape 3-25, 3-25 
“dead escape 3-39 
“e escape 3-23 
“editor escape 3-39 
“h escape 3-24 
“headers escape 3-39 
“M escape 3-25 
“m escape 3-25 
“Message escape 3-39 
“message escape 3-39 
“p escape 3-23 
“print escape 3-39 
“quit escape 3-39 
“r escape 3-25 
“read escape 3-40 
“s escape 3-23 
“subject escape 3-40 
“t escape 3-23 
“to escape 3-40 
“v escape 3-23 
“visual escape 3-40 
“w escape 3-25 
“write escape 3-40 
“| See shell escape (“|) 

““ See tilde quote escape (““) 
mailbox 

cleaning out 3-32 
command 3-19 
reading in 3-9 
system mailbox 3-5 
user mailbox 

filename 3-5 

message saving notation 3-17 
Marking See ed 
mb command See mail 
mbox command See mail 
mchron option 
mail 3-41 

mesg option See vi 
Metacharacter 
asterisk (*) 4-57 
brackets ([]) 4-57 
directory name use avoidance 4-4 
escape 4-4 
list designated 4-57 
mail 3-7, 3-15 
question mark (?) 4-57 
redirection restriction 4-6 
metoo option See mail 
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Minus sign (-) 
be 

subtraction operator symbol 5-4 
unary operator symbol 5-4, 5-16 
mail, message advancement 3-34 
redirection effect 4-39 
subtraction operator symbol 5-4 
variable conditional substitution 4-41 
MKFILES shell procedure 4-53 
Multiple way branch See case command 
Multiplication See be 


N 


n command See vi 
Name grammar 4-56 
newgrp command 
description 4-32 
shell built-in command 4-43 
special shell command 4-32 
Newline substitution See ed 
next command See vi 2-50 
nohup command 4-21 
nosave option See mail 
Notational conventions 1-3 
nu command See vi 2-25 
Null command See Colon command (:) 
NULL shell procedure 4-53 
Number sign (#), comment symbol 4-57 


O 


Operator See be 
Option 

See also Specific Option 
DRAFT shell procedure 4-50 
invocation flags 4-42 
mail options See mail 
tracing, $- variable 4-15 
Options 

vi options See vi 
Or-if operator (||) 
command list 4-20 
description, use 4-21 
designated 4-57 
Output 

append symbol (>>) 4-6, 4-57 
creation symbol (>) 4-57 
diagnostic output file 4-6 
error redirection 4-40 
grammar 4-56 
standard error file 
See diagnostic output file 
standard output file 4-6 


p 


p command 
ed use See ed 
mail 

message printing 3-3, 3-7, 3-14, 3-36 
syntax 3-8 

page option See mail 
Parentheses (()) 
be 

expression enclosure 5-15 
function identifier argument 
enclosure 5-14 

command grouping 4-27, 4-44, 4-57 
pipeline, command list enclosure 4-22 
test command operator 4-37 
Path variable 
C-shell use See C-shell 
PATH variable 
conditional substitution 4-42 
description 4-13 
directory search 
effect 4-46 
sequence change 4-3 
Pattern matching facility 
case command 4-24 
expr command argument effect 4-38 
limitations 4-4 

metacharacter See Metacharacter 
redirection restriction 4-6 
shell function 4-3 
variable assignment, 
not applicable 4-11 
grammar 4-56 
metacharacter 4-57 

Percentage sign ("), be modulo operator 
symbol 5-4 
Period (.) 
ed use See ed 

pattern matching facility restrictions 
4-4 

vi See vi 

PHONE shell procedure 4-54 
PID 

$! variable 4-15 
$$ variable 4-14 
Pipe 

compose escapes See mail 
file interchange 4-50 
symbol (|) 4-57 
Pipeline 

C-shell use See C-shell 
command list 4-22 
defined 4-20 
description 4-7 
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Pipeline ( continued ) 

DISTINCT! shell procedure 4-49 
filter 4-7 
grammar 4-56 
notation designated 4-7 
procedure 4-7 
Plus sign (+) 
be 

addition operator symbol 5-4 
unary operator symbol 5-16 
mail, message advancement 3-11, 3-34 
variable conditional substitution 4-42 
Positional parameter 
description 4-10 
direct access 4-18 
null value assignment 4-41 
number yield, $# variable 4-14 
parameter substitution 4-11 
positioning 4-11 
prefix ($) 4-11 
setting 4-11 

variable assignment statement 
positioning 4-11 
Printing 

command See p command 
ed See ed 
mail See mail 
Process 

defined 4-2 
number See PID 
ps command 

C -shell use See C- shell 
PS1 variable 4-13 
PS2 variable 4-13 


Q 

q command 
ed exit See ed 
mail 

exit 3-4, 3-9, 3-18, 3-36 
message abortion 3-29 
q! See vi 

Question mark (?) 

directory name, use avoidance 4-4 

ed use See ed 

mail 

command summary printing 3-34 
compose escape listing 3-2, 3-12, 3-23 
help command 3-3, 3-14 
metacharacter 4-3, 4-57 
pattern matching See metacharacter 
variable conditional substitution 4-41 
quiet option See mail 
quit command 

See also q command 
be exit 5-2, 5-3 


QUIT key, background process immunity 4-21 
Quotation marks, back (“) 
command line substitution 4-9 
command substitution 4-4, 4-9 
quoting 4-58 

Quotation marks, double (") 

4-11, 4-36, 4-58 

Quotation marks, double (") 4-4, 4-42 
Quotation marks, single (”) 
metacharacter escape 4-4 
trap command 4-29 
variable substitution inhibition 4-11 
Quotation marks, single (") 

C-shell use See C-shell 
Quoting 

backslash (\) use 4-58 
metacharacter escape 4-4 
quotation marks, back (“) use 4-58 
quotation marks, double (") 4-58 


R 


R command See mail 
r command 
ed use See ed 
mail use See mail 
read command 
exit status 4-33 
shell built-in command 4-43 
special shell command 4-33 
Read command 
vi See vi 

Read See r command 
readonly command 
description 4-33 
shell built-in command 4-43 
special shell command 4-33 
Record string See mail 
Redirection 

argument location 4-9 
case command 4-28 
cd arg command 4-32 
control command 4-28 
diagnostic output 4-6 
file descriptor 4-40 
for command 4-28 
if command 4-28 
minus sign (-) effect 4-39 
pattern matching use restriction 4-6 
simple command line, 
appearance 4-20 

special character use restriction 4-6 
special shell command, 
restriction 4-32 
symbol (<) 4-57 
symbol (>) 4-57 
until command 4-28 
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Redirection ( continued ) 
while command 4-28 
Regular expressions See ed 
rehash command 
C-shell use See C-shell 
Reminder service 
mail 3-32 
Repeat command 
see vi 2-47 

reply command See mail 
Report option See vi 
Reserved word listing 4-58 
Return code See $? variable 
RETURN key 
be 5-2 


s 


s command 
ed use See ed 
mail 3-17, 3-18, 3-18, 3-37 
scale command 5-7 
Scale See be 

Screen- oriented commands See vi 2-12 
Scripts See ed 
Scripts See Shell 
se command See set command 
Search See ed 
Searching See / command 
Searching See vi 
vi procedure See vi 
sed command See ed 
Semicolon (;) 

be, statement separation 5-3, 5-19 
C-shell use See C-shell 
case command break 4-24 
case delimiter symbol 4-57 
command list 4-20 
command separator symbol 4-57 
ed use See ed 
Serial lines 

modem connection 6-3, 6-5 
set all See vi 
set command 
C-shell 

variable value assignment 7-2 
mail 

description, use 3-21, 3-37 
option control 3-40 
name-value pair listing 4-18 
positional parameters setting 4-11 
shell built-in command 4-43 
shell flag setting 4-16 
special shell command 4-32 
sh command 
description 4-1 
mail 3-21, 3-34, 3-37 


sh command (continued) 
shell invocation 4-18 
Shell command 
executing while in vi 2-15 
SHELL string 3-29, 3-41 
Shell 

-e option 4-35 
-k option 4-36 
-n option 4-36 
-t option 4-36 
-u option 4-35 
-v option 4-16 
-x option 4-16 
argument passing 4-18 
command 

search procedure 4-3 
special command 
See special command 
compose escapes See mail 
conditional capability 4-22 
creation 
procedure 4-2 
description 4-1 
entry, mail mode source 3-22 
escape 

ed procedure See ed 
mail procedure See mail 
execution 
flag See option 
sequence 4-19 
termination 4-27 
exit 

-e option 4-35 
-t option 4-36 
mail mode return 3-22 
procedure 4-27 
function 4-1 
grammar 4-56 

in-line input document handling 4-39 
interactive 4-42 
interruption procedure 4-29 
invocation 
option 4-42 
procedure 4-18 
mail 

invocation 3-6 
shell commands 3-21 
option 

See also Specific Option 
designated, use 4-35 
setting 4-16 

pattern matching facility See Pattern 
matching facility 

positional parameter See Positional 
parameter 
procedure 

See also Specific Shell Procedure 
advantages over C programs 4-35 
byte access reduction consideration 
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Shell ( continued ) 
procedure ( continued ) 

4-45 

creation 4-34 
description 4-2 
directory 4-35 
efficiency analysis 4-44 
efficiency awareness 4-44 
examples designated 4-47 
filter order consideration 4-45 
option See option 
scripts designation 4-47 
time command 4-43 
writing strategies 4-43 
redirection ability 4-6 
scripts See procedure 
special command 

See also Specific Special Command 
designated 4-32 
redirection restriction 4-32 
special shell variable 4-19 
state 4-15 

string See SHELL string 
variable See Variable 
shift command 
argument processing 4-18 
shell built-in command 4-43 
si command See mail 
Simple command See Command 
Slash (/) 

be, division operator symbol 5-4 
command prepending suppression 4-3 
ed use See ed 
search command See vi 
so command See mail 
Special character See Metacharacter 
ed use See Ed 

pattern matching facility 4-3 
Standard error file See Output 
Standard error output See Error output 
Standard input file See Input 
Standard output file See Output 
Star (*) 

See also Asterisk (*) 
ed metacharacter See ed 
String option See mail 
String variable 4-11 
searching for See Search 
Subshell, directory change 4-15 
Substitution command See s command 
Subtraction See be 
Switch See Option 
System security with uucp See uucp 
mailbox See mailbox 


System security with uucp See uucp 
(continued) 


T 


t command 
ed use See ed 

mail 3-12, 3-16, 3-16, 3-37 
Table command See ed 
Tabs 
ed See ed 

tbl command See ed 
Temporary file 
trap command, removal 4-30 
use recommendation 4-14 
term option See vi 
terse option See vi 
test command 
argument 4-38 

brackets ([]) use in lieu of 4-36 
description, use 4-36 
operators 4-37 
options 4-37 

shell built-in command 4-43 
Text editor 
ed See ed 
ex See ex 
vi See Vi 

TEXTFILE shell procedure 4-54 
then clause See if command 
Tilde escape See mail 
time command 4-43 
Top command See t command 
Toplines option See mail 
Toplines string See mail 
Transfer command See t command 
trap command 
description, use 4-29 
implementation method 4-31 
multiple traps 4-31 
special shell command 4-32 
temporary file removal 4-30 
troff See ed 
true command 4-39 
ttys file 

and uucp 6-13 


u 


u command See vi 2-45 
ed use See ed 
mail 3-8, 3-17, 3-37 
vi See vi 
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umask command 
description 4-33 
shell built-in command 4-43 
special shell command 4-33 
Undo command See u command 
Undo command See vi 
Undo command See vi 2-45 
unset command See mail 
until command 

continue command effect 4-26 
description, use 4-25 
exit status 4-25 
redirection 4-28 
shell built-in command 4-43 
User 

mailbox See mailbox 
uucico 6-31 
uucico See also uucp 
calling a remote site 6-38 
handshake sequence 6-39 
line protocol 6-39 
terminating a conversation 6-40 
functions 6-36 
MASTER mode 6-37 
options 6-37, 6-37 
processing work 6-39 
scanning for work 6-37 
SLAVE mode 6-37 
special shell 6-36 
starting 6-37 

terminating a conversation 6-40 
work files 6-37 
uuclean 6-31 
uuclean See also uucp 
uucp 

/etc/ttys 6-13 
/usr/lib/uucp 6-31 
/usr/spool/uucp 6-31 

C. * files 6-37 

calling a remote site 6-38 
handshake sequence 6-39 
line protocol 6-39 
terminating a conversation 6-40 
command syntax 6-32 
copying files between sites 6-34 
copying files to a local destination 
6-33 

cron 6-9, 6-21 
automatic cleaning 6-30 
crontab 6-24 

automatic cleaning 6-30 

D. * files 6-37 

details of operation 6-30 
directories and files 6-31 
types of files 6-31 
uucico 6-36 
dial 6-31 
dial in site 6-12 
dial out site 6-20 


uucp ( continued ) 
dialing in 6-12 
dialing in and out 6-25 
enable command 6-20 
dialing out 6-20 
L-devices 6-20 
L-devices file 6-22 
directories and files 6-31 
execute file 6-35 
installing 6-7 
Introduction 6-1 
L-devices 6-10, 6-20, 6-22 
L-dialcodes 6-10, 6-20, 6-23 
used in L.sys 6-23, 6-24 
L.cmds 6-10, 6-12, 6-17, 6-20, 6-41 
L.sys 6-10, 6-17, 6-20 
LCK* files 
description 6-38 
LCK..* files 6-30 

limiting permissible commands (with 
L.cmds) 6-17 
linking micnet sites 6-26 
lock files 6-30 
description 6-38 
LOGFILE 6-27 
login entries 6-14 
maintaining the system 6-26 
cleaning the spool directory 6-27 
creating maintenance shell files 6-30 
locked devices 6-29 
locked sites 6-29 
log files 6-27 
reclaiming data files 6-28 
reclaiming log files 6-28 
transmission status 6-29 
uuclean 6-27 
MASTER mode 6-37 
modem 6-2 

connecting a modem 6-6 
dialing configuration 6-5 
dialing in 6-12 
dialing out 6-20 
installing 6-4 
pin connections 6-2 
serial lines 6-3, 6-5 
testing 6-6 
options 6-32 
processing work 6-39 
programs 6-30 
receiving files 6-33 
sending files to remote sites 6-34 
serial line 

enabling 6-13, 6-21 
serial lines 6-3, 6-5 
sitename 

choosing 6-11 
SLAVE mode 6-37 
special (meta) characters 6-32 
standard input line (execute file) 6-36 
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uucp ( continued ) 
standard output 6-36 
standard output line (execute file) 6-36 
STST.* files 6-29 
system security 6-41 
L.cmds 6-41 
systemid 6-10 
systemid file 
creating 6-11 

terminating a conversation 6-40 
TM.* files 6-28 
transmission schedule 6-24 
cron 6-24 
crontab 6-24 
dialing in and out 6-25 
types of work 6-33 
copying files between sites 6-34 
copying files to a local destination 
6-33 

receiving files 6-33 
sending files to remote sites 6-34 
USERFILE 6-10, 6-12, 6-20, 6-34 
setting up 6-15 
using mail with uucp 6-26 
uucico 6-24, 6-31, 6-33 
calling a remote site 6-38 
forcing a call (-s) 6-25 
forcing a call at any time (-S) 6-25 
from a shell script 6-25, 6-25 
functions 6-36 
options 6-37, 6-37 
scanning for work 6-37 
special shell 6-36 
starting 6-37 
work files 6-37 
uuclean 6-27, 6-31 

automatic cleaning with cron 6-30 
lock files 6-30 
uuinstall 6-9 
L-devices 6-22 
L.sys 6-19 
systemid 6-12 
usage 6-9 
USERFILE 6-16 
with -r option 6-11 
uulog 6-27, 6-31 

automatic running with cron 6-30 
uux 6-1, 6-31, 6-34 
comand syntax 6-34 
LOGFELE 6-27 
options 6-34 
PATH in uuxqt 6-36 
standard input (“-” option) 6-34, 6-35 
standard input line (execute file) 6-36 
standard output 6-35 
standard output line (execute file) 6-36 
uuxqt 6-31, 6-40 
execute file 6-35" 

PATH 6-36 


uucp ( continued ) 

What you need 6-2 
X.* files 6-37 
uulog 6-31 
uulog See also uucp 
uux 6-1, 6-31, 6-34 
uux See also uucp 
command syntax 6-34 
options 6-34 

standard input (“-” option) 6-34, 6-35 
standard input line (execute file) 6-36 
standard output 6-35, 6-36 
standard output line (execute file) 6-36 
uuxqt 

execute file 6-35 
uuxqt 6-31, 6-40 
uuxqt See also uucp 


v 


v command 
ed use See ed 
mail 3-7, 3-21, 3-37 
Value See $? variable 
Variable 
$! variable 4-15 
$# variable 4-14 
$$ variable 4-14 
$- variable 4-15 
$? variable 4-14 
assignment 

line command 4-9, 4-9 
string value 4-11 
be variable See be 
command environment composition 
4-17 

conditional substitution 4-41 

description 4-10 

double quotation marks (") 4-11 

enclosure 4-12 

execution sequence 4-11 

expansion 4-5 

export 4-14 

expr command 4-38 

file creation 4-29 

global check 4-36 

HOME See HOME variable 

IFS See IFS variable 

keyword parameter 4-17 

listing procedure 4-17 

MAIL See MAIL variable 

name defined 4-11 

null value assignment procedure 4-41 
PATH See PATH variable 
positional parameter See Positional 
parameter 
prefix ($) 4-11 
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Variable (continued) 

PS1 See PS1 variable 
PS2 See PS2 variable 
set variable defined 4-41 
special variable 4-14 
string value assignment 4-11 
substitution 

-u option effect 4-35 
double quotation marks (") 4-11 
notation 4-58 
redirection argument 4-6 
single quotation marks (”) 4-11 
space interpretation 4-12 
test command 4-36 
types designated 4-12 
Vertical bar ( |) 
pipeline notation 4-7 
Vertical bar ([) 
mail escape 3-26 
or-if operator symbol (|[) 4-20 
Vi, mail 

compose escape, ~v 3-40 
editing 3-21 

entry from command mode 3-7 
entry from compose mode 3-7 
VISUAL string 3-41 
vi 

. command See dot (.) command 
See dot (.) command 
.exrc file 2-60 
.login file 

terminal type setting use 2-56 
.profile file 

terminal type setting 2-56 
/ command 
searching 2-10 
0 command 

cursor movement 2-6 
:q! 2-16 
:x 2-16 

:x command 2-48 
appending text 
A 2-22 
a 2-22 


vi ( continued ) 

caret (*), pattern matching 2-43, 2-44 
cc command 2-33 
co (copy) command 2-25 
colon (:) 

line-oriented command, use 2-12 
status line prompt 2-12 
Command mode 
cursor movement 2-5 
entering 2-3 
command 

line-oriented See line-oriented commands 
2-12 

repeating, dot (.) use 2-6 
screen -oriented See screen-oriented 
commands 2-12 

control characters, inserting 2-28 
copying lines 2-25 
correcting mistakes 2-23 
crash, recovery 2-54 
Ctrl-b 

scrolling 2-6 
Ctrl-d 

scrolling 2-6 
sub shell exit 2-54 
Ctrl-f 

scrolling 2-6 
Ctrl-g 

file status information 2-11, 2-53 
Ctrl-j, inserting 2-28 
Ctrl-1 

screen redraw 2-54 
Ctrl-q, inserting 2-28 
Ctrl-s, inserting 2-28 
Ctrl-u 

deleting an insertion 2-30 
scrolling 2-6 
Ctrl-v, use 2-28 
current line 
deleting 2-6, 2-29 
designated 2-2 
line containing cursor 2-4 
number, finding out 2-25 
cursor movement 


See also inserting text 

$ key 2-20 

args command 2-50 

+ key 2-20 

b command, cursor movement 2-6 

B 2-19 

breaking lines 2-28 

b 2-19 

buffers 

backward 2-20 

delete 2-36 

BKSP 2-18 

delete See delete buffer 

by character 2-18 

naming 2-25 

by lines 2-20 

selecting 2-25 

by words 2-19 

C command 2-32 

Ctrl-n 2-20 

C shell 

Ctrl-p 2-20 

prompt 2-56 

down 2-5, 2-18 

TERM variable 2-56 

E 2-19 

terminal type setting 2-56 

e 2-19 

canceling changes 2-48 

F 2-18 
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vi ( continued ) 

cursor movement ( continued ) 
f 2-18 

forward 2-20 
h 2-18 
H 2-21 
j 2-18, 2-20 
k 2-18, 2-20 
keys 2-5 
1 2-18 
L 2-21 

left 2-5, 2-18, 2-18, 2-19 
line beginning 2-6 
line end 2-6 
LINEFEED key 2-20 
lower left screen 2-5 
M 2-21 

RETURN key 2-20 
right 2-5, 2-18, 2-19 
screen 2-21 

scrolling See scrolling 2-6 
See also scrolling 
SPACEBAR 2-18 
T 2-18 
t 2-18 

to end of file 2-5 
up 2-5, 2-18 
upper left screen 2-5 
W 2-19 
w 2-19 

word backward 2-6 
word forward 2-6 
cursor movment 
right 2-18 
cw command 2-32 
D command 2-6 
d$ command 2-6 
dO command 2-6 
date, finding out 2-15 
dd command 2-6 
delete buffer 
use 2-36 
deleting text 
by character 2-28 
by line 2-29 
by word 2-29 
D 2-29 

dd command 2-29 
deleting an insertion 2-30 
dw command 2-29 
methods 2-6 
repeating deletion 2-47 
undoing 2-45 
undoing deletion 2-5 
X command 2-28 
x command 2-28 
demonstration 2-1 
description 2-1 
dollar sign ($) 


vi (continued) 

dollar sign ($) (continued) 
cursor movement 2-6 
pattern matching 2-43 
dollar sign($) 
use in line address 2-30 
dot (.)command See . command 2-6 
dot See also dot (.) command 
dot, use in line address 2-30 
dw command 2-6 
editing several files 

changing the order 2-50 
end-of-line 
displaying 2-57 
entering 

at a specified line 2-17 
at a specified word 2-18 
procedure 2-2 
with filename 2-17 
with several filenames 2-49 
error messages 
shortening 2-59 
turning off 2-52 

ESCAPE, Insert mode exit 2-3, 2-54 
exclamation point (!) 

shell escape 2-15 
exiting 
:q! 2-16 
:x 2-16 

:x command 2-48 
saving changes 2-48 
saving file 2-14 
temporarily 2-15, 2-52 
without saving changes 2-48 
ZZ command 2-48 
file 

creating 2-2 

not saving, :q! 2-16 

saving 2-16 

status information display 2-11 
status information procedure 2-11 
filename 

finding out 2-53, 2-53 
planning 2-49 
G command 
cursor movement 2-5 
goto command See G command 
H command 
cursor movement 2-5 
h command 

cursor movement 2-5 
i command 

inserting text 2-3 

ignorecase option 2-39, 2-57, 2-58 
Insert command See i command 
Insert mode 
entering 2-3 
exiting 2-3 

inserting text from another file 2-14 
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inserting text from another file 

2-14 ( continued ) 

See also appending text 
control characters 2-28 
from other files 2-23, 2-24 
12-22 
i 2-22 

repeating insert 2-23, 2-47 
undoing 2-45 
undoing insert 2-54 
undoing insertion 2-5 
invoking See entering 
j command 

cursor movement 2-5 
joining lines 2-28 
k command 

cursor movement 2-5 
L command 

cursor movement 2-5 
1 command 

cursor movement 2-5 
leaving See exiting 
line addressing 
dollar sign 2-30 
dot(.) 2-30 
procedure 2-29 
line numbers, displaying 
:nu command 2-54 
linenumber option 2-16, 2-58 
nu command 2-25 
number option 2-25 
line-oriented Command mode 2-53 
line-oriented commands 
:args 2-50 
:e 2-24, 2-51 
:e# 2-24, 2-51 
:f 2-53 
:file 2-53 
:n 2-50 

:nu 2-25, 2-54 
:q 2-48 
:r 2-23 
:rew 2-50 
:s 2-33, 2-33 
:w 2-24 
:wq 2-48 

colon (:) use 2-12 
deleting text 2-29 
entering 2-12 
moving text 2-34 
status line, display 2-11 
list option 2-57 
magic option 2-45, 2-59 
marking lines 2-24 
mesg option 2-60 
mistakes, correcting 2-23 
mode, determining 2-54 

See also command mode 2-54 


vi (continued) 

mode, determining 2-54 (continued) 

See also Insert mode 2-54 
See also line-oriented command mode 2- 
54 

moving text 2-34 
n command 2-10, 2-39 
new line, opening 2-23 
next command 2-50 
number option 2-58 
opening a new line 2-23 
options 

displaying 2-57 
ignorecase 2-39, 2-57 
list 2-16, 2-57 
magic 2-45, 2-59 
mesg 2-60 

number 2-25, 2-34, 2-58 
report 2-58 
setting 2-55, 2-57 
term 2-58 
terse 2-59 
warn 2-52, 2-59 
wrapscan 2-40, 2-59 
overstrike commands 2-30 
pattern matching 
See also searching 
beginning of line 2-43 
caret Q 2-44 
character range 2-44 
character, single 2-44 
end of line 2-43 
exceptions 2-44 
generally 2-43 
special characters 2-44 
square brackets ([]) 2-44 
period (.) 

pattern matching 2-44 
Repeat command symbol 2-4 
problem solving 2-54 
putting 2-24 

Q command, line-oriented Command mode 
2-53 

quitting See exiting 2-48 
r comand 2-14 
r command 2-30, 2-30 
read command 2-14 
redrawing the screen 2-54 
Repeat command 2-47 
repeating a command 2-47 
replacing a line 2-32, 2-33 
replacing a word 2-32, 2-33 
report option 2-58 
rew command 2-50 
S command 2-32 
s command 2-32 
saving a file 2-49 
screen, redrawing 2-54 
screen- oriented commands 2-12 
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vi ( continued ) 
scrolling 

backward 2-6, 2-6 
down 2-6, 2-21 
forward 2-6 
up 2-6, 2-21 
searching and replacing 
a word 2-41 
c option 2-42 
choosing replacement 2-42 
command syntax 2-40 
p option 2-42 
printing replacement 2-42 
searching See / command 
See also searching and replacing 
backward 2-39 
caret 2-43 
caret Q use 2-43 
caret( ) 2-44 
case signficance 2-58 
case significance 2-39 
dollar sign ($) 2-43 
forward 2-10, 2-38 
next command 2-39 
period (.) 2-44 
procedure 2-10 
repetition 2-10 
special characters 2-39, 2-59 
square brackets ([]) 2-44 
status line, display 2-11 
wrap 2-10, 2-40, 2-59 
session, canceling 2-16 
set all, option list 2-16 
set command 2-55, 2-57 
setting options 2-57 
shell command, executing 2-15 
shell escape 2-52 
slash (/) 

search command delimiter 2-10 
special characters 
matching 2-44 
searching for 2-39, 2-59 
vi filenames 2-49 
status line 

line-oriented command entry 2-12 
location 2-11 

prompt, colon (:) use 2-12 
string 

pattern matching 2-44 
searching for See searching 
subshell 
exiting 2-54 

Substitute commands 2-32 
switching files 2-51 
system crash 
file recovery 2-55 
tabs 

displaying 2-57 
TERM variable 2-56 


vi ( continued ) 

TERM variable 2-56 ( continued ) 
Bourne shell 2-56 
Visual Shell 2-56 
termcap 2-56 
terminal type setting 
Bourne shell 2-56 
C shell 2-56 
how 2-58 
Visual Shell 2-56 
terse option 2-59 
time, finding out 2-15 
u command 2-4, 2-45, 2-54 
Undo command See u command 
undoing a command 2-45 
w command, cursor movement 2-6 
warn option 2-52, 2-59 
warnings, turning off 2-59 
word, deleting 2-6 
wrapscan option 2-40, 2-59 
write messages 2-60 
writing out a file 

:wq command 2-48, 2-49 
x command 2-6 
yanking lines 2-24, 2-27 
ZZ command 2-48 
visual command See mail 
visual shell(vsh) 
description 8-1 
Visual Shell 
TERM variable 2-56 
terminal type 2-56 
VISUAL string See mail 
vsh 
Alt-h 

help key 8-2 
cancel key 8-3 
command option menu 8-3 
command output 8-9 
shell output 8-9 
vshell output 8-9 
command piping 8-11 
copy file or directory option 8-6 
count option 8-11 
create file system 8-8 
Ctrl-C 

cancel key 8-3 
cursor motion keys 8-3 
delete file or directory option 8-7 
description 8-1 
edit a file 8-7 
editing options keys 8-3 
entering the shell 8-2 
exit 8-10 
file systems 
check file system 8-9 
get option 8-11 
grep 8-11 

head option 8-11, 8-12 
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vsh ( continued ) 
help key 8-2 
help menu 8-7 
invoking commands 8-6 
invoking the shell 8-2 
keystrokes 8-2 
leave 8-10 
leaving 8-2 
list files 8-10 
mail option 8-7 
main menu 8-3 
menu selection 8-3 
message line 8-3 
more 8-12 
more option 8-12 
move cursor 8-3 
name option 8-8 
options menu 8-8 
file systems 8-8 
list files 8-8 
make directory 8-8 
pattern recognition 8-11 
permissions option 8-9 
pipe options 8-11 
print a file 8-10 
print option 8-10 
quit 8-10 
quit key 8-2 
rename file option 8-8 
run option 8-10 
run shell command 8-10 
scroll through file 8-12 
send file to printer 8-10 
set file permissions 8-9 
shell command 8-10 
sort option 8-11, 8-12 
status line 8-2 
tail option 8-11, 8-13 
view file 8-10 
view option 8-10 
view window 8-4 
motion keys 8-5 
moving cursor 8-4 
window adjustment 8-11 
window motion keys 8-5 
window option 8-11 
word, line, character counts 8-11 


wait command 
description 4-33 
exit status 4-33 
shell built-in command 4-43 
special shell command 4-33 
warn option See vi 
while command 
break command effect 4-26 
continue command effect 4-26 
description, use 4-24 
exit status 4-25 
loop 4-48 
redirection 4-28 
shell built-in command 4-43 
test command 4-36 
Word 

grammar 4-56 
wrap scan option See vi 
wrapscan option See vi 2-40 
Write out See w command 
WRITEMAIL shell procedure 4-55 


x 


x command See vi 
mail 

exit 3-18, 3-35 
session abortion 3-11 
vi use See vi 
XENIX command 
directory residence 
C- shell 7-3 


z 


z 

vi scroll 2-21 
ZZ command See vi 2-48 


w 


w command See vi 
ed use See ed 
mail 

message saving 3-18 

message write out 3-38 

system mailbox, message deletion 3-18 
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